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About This Book 


What this book is about 


ABIOS for IBM PS/2 Computers and Compatibles is a detailed technical 
reference that describes the ABIOS, the portion of the PS/2 ROM BIOS de- 
signed to support multitasking operating systems such as OS/2. The informa- 
tion provided in this book is applicable to all Micro Channel Architecture- 
based IBM PS/2 and compatible computers. 


Who should read this book 


This book can be used by anyone interested in learning more about PS/2 or 
compatible computers. 


Programmers who wish to make direct calls to the ABIOS will find complete 
instructions for accessing the ABIOS via any version of OS/2 (e.g. IBM OS/2) 
that supports DevHIip services ABIOSCommonEntry and ABIOSCall. 


Programmers writing device drivers for new peripheral devices will find the 
general information on ABIOS services helpful. They will also find, in the 
chapter on ABIOS extensions, a complete description of how ABIOS services 
can be added, replaced, or modified. 


Implementers of operating systems and other multitasking system software 
and systems programmers will find all the information they need on ABIOS/ 
operating system interfaces. 
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What we assume you know 


This book assumes a basic knowledge of 80x86 assembly language program- 
ming concepts, PC architecture, and operating system concepts. If you are 
new to these subjects, use this book along with some of the excellent intro- 
ductory books listed at the end of this book. 


How to find information 


Chapters 1-7 of AB/OS for IBM PS/2 Computers and Compatibles provide a. 
general introduction to ABIOS concepts and describe how to use ABIOS 
services. Chapters 8-23 describe the individual ABIOS services and serve as 
a technical reference. The Appendix provides a comprehensive list of poten- 
tial error messages and Return Codes. Most readers will want to read chap- 
ters 1-7 first to get a basic grasp of the ABIOS features before turning to 
the individual service descriptions. 


Each service-specific chapter (8-23) is organized in a similar fashion. There 
is a description of the service and its hardware environment, a discussion on 
how errors are handled, and complete descriptions of each service function. 
The function descriptions include a description of what the function does, a 
graphic outline of the required Request Block structure and a list of Return 
Codes. 


Other volumes in this series 


ABIOS for IBM PS/2 Computers and Compatibles is one of several volumes 
about BIOS software in the Phoenix Technical Reference Series published by 
Addison-Wesley. Other volumes are: , 


CBIOS for IBM PS/2 Computers and Compatibles — a complete 
technical reference describing the portion of a PS/2 BIOS designed 
to support single—-tasking operating systems such as MS-DOS. 


System BIOS for IBM PC/XTIAT Computers and Compatibles — a 
complete technical reference for the BIOS in all standard architec- 
ture computers. 


The BIOS volumes of the Phoenix Technical Reference Series provide the - 
most comprehensive source of information about IBM and compatible system 
BIOSs available today. Each volume lists complete I/O port addresses, CMOS 
RAM, and BIOS data definitions. Every function is described in detail, and 
complete lists of error messages are provided. 


The volumes of this series are a natural companion for anyone who owns 
and programs an IBM PC, XT, AT, or PS/2 model, or any compatible 
system. 
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Acronyms and Abbreviations 


The following abbreviations and acronyms are used in this manual: 


ASCII 
ASIC 


American Standard Code for Information Interchange 
Application—Specific Integrated Circuit 
Binary 

Binary coded decimal 

Basic input/output system 

Bits per second 

Common data area 

Color graphics adapter 

Cyclic redundancy check 
Complementary metal oxide semiconductor 
Device Block 

Direct memory access 

Device service routine 

Error checking and correction 
Enhanced graphics adapter 

End of interrupt | 
Enhanced small device interface 
Function transfer table 
Hexadecimal 

Interrupt 

Input/Output 

Interrupt request line 

Interrupt service routine 
Kilobytes 

Kilobits per second 

Logical ID 

Least significant byte 

Large scale integration 
Megabytes 

Monochrome Display Adapter 
Modified frequency modulation 
Megahertz 


continued 
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Acronyms and Abbreviations, Continued 


MSB 
NMI 
OS/2 
PGA 
POS 


~ POST 


xxii 


PTL 
RAM 
RB 
RLL 
ROM 
RTC 
VGA 
VLSI 


Most significant byte 
Nonmaskable interrupt 
Operating System/2 
Professional graphics adapter 
Programmable Option Select 
Power-on self test 

Phoenix Technologies Ltd. 
Random access memory 
Request block 

Run length limited 
Read-only memory 

Real time clock 

Video graphics array 

Very large scale integration 
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Chapter 1 
The ABIOS 


Overview 


What is the PS/2 BIOS? 


The ROM BIOS contained in Micro Channel Architecture-—based !BM PS/2 and 
compatible Computers performs the same function that all basic input/ 
Output systems do: it isolates the operating system from direct manipulation 
of hardware registers, timings, and attachments. 


When compared with the ROM BIOS contained in IBM PC XT/AT and compat- 
ible computers, however, the PS/2 ROM BIOS has one critical difference — it 
is designed to support two kinds of operating systems. As such, the PS/2 
ROM BIOS is divided into two discrete parts: the ABIOS and the CBIOS. 


The CBIOS 


The CBIOS part of the PS/2 ROM BIOS provides IBM PS/2 and compatible 
computers backward compatibility with single-tasking, Intel 80x86 real ad- 
dress mode operating systems such as PC-DOS or MS-DOS. As a result, 
the CBIOS consists of a superset of the services and functions available in 
the IBM PC/XT/AT ROM BIOS, and it interfaces with the operating system in 
the same well understood way. 


continued 
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Overview, Continued 


The ABIOS 


The ABIOS part of the PS/2 ROM BIOS provides IBM PS/2 and compatible 
computers with forward compatibility with multitasking, bimodal (real mode, 
protected mode, or both) operating systems, such as IBM OS/2. The ABIOS 
supports the same hardware devices as the CBIOS, but its interface and 
data structures are specifically constructed to facilitate the multitasking, 
bimodal nature of its design. 


Program accessibility 


The program accessibility of any ROM BIOS depends on the architecture of 
the operating system interfaced with the BIOS. 


# ABIOS Accessibility 
Starting with IBM OS/2 Version 1.1, programs have full access to the 
ABIOS through the operating system via the two IBM OS/2 DevHlip serv- 
ices: ABIOSCommonEntry and ABIOSCall. ABIOS accessibility for versions 
of OS/2 other than IBM’s varies from vendor to vendor. Programmers who 
are not using IBM OS/2 should refer to their OS/2 documentation to deter- 
mine if their version of OS/2 supports program access to the ABIOS. 


= CBIOS Accessibility 


Under the totally open architecture of PC-DOS or MS-DOS, application 
programs interface directly with the CBIOS. In fact, many MS-DOS appli- 
cation programs attempt to improve performance by bypassing MS-DOS 
system services in favor of the more direct CBIOS services. 


Scope of this document 


This book describes the ABIOS component of the PS/2 BIOS. The information 
is 100 percent applicable to both the IBM and the Phoenix Technologies Ltd. 
versions of ABIOS. | 


continued 
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Overview, Continued 


In this chapter 
This chapter outlines the major concepts and design features of the ABIOS. 
The following topics are discussed: 
» ABIOS Device Support | 
» The ABIOS Processing Model 
» ABIOS Data Structures 
»® ABIOS Initialization Facts 
= Request Block Initialization 
=» Transfer Conventions 
e ABIOS and End User Access 
» Accessing ABIOS via ABIOSCommonEntry 
» Accessing ABIOS via ABIOSCall 
» Return Code Handling 
= ABIOS Extensions 
» Where to Find More Information 


For more information on the CBIOS 


For a complete treatment of the CBIOS, see CB/OS for IBM PS/2 Computers 
and Compatibles in this series. 
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ABIOS Device Support 


Introduction 


The ABIOS occupies 64K of the 128K PS/2 BIOS. The ABIOS supports 16 
kinds of physical devices. There is one ABIOS device service for each 
physical device. 


ABIOS supported devices 


The table below lists the physical devices supported by the ABIOS and the 
ABIOS device IDs assigned to them. 


ABIOS Internal Calls 
Diskette 
Fixed Disk 


ideo 
eyboard 


System Timer 


System Services 


Standard ABIOS functions 


Functions numbered OOh-O9h are standard functions across all ABIOS serv- 
ices. Functions 10h-xxh are tailored to the device being serviced. 


Default Interrupt Handler 
Return Logical ID Parameters 
Reserved 

Read Device Parameters 

Set Device Parameters 


Reset/Initialize 
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The ABIOS Processing Model 


Introduction 


In a traditional PC-based ROM BIOS (such as the CBIOS), all functions are 
processed on the single-staged, call/process/return model. Once a function 
is invoked, the CPU is prevented from turning to other work until the function 
completes and returns. If the function called must interface with slower 
external hardware, the BIOS initiates a Wait and suspends CPU processing 
until the hardware interrupt occurs. The resulting amount of idle CPU time 
can be considerable. 


Single-staged processing/single-tasking operating systems 


Although this single-staged call/return method is somewhat inefficient, the 
fact that the BIOS is interfaced with a single-tasking operating system mini- 
mizes the method’s impact on system throughput. A BIOS that processes 
functions exclusively on the single-staged model is therefore best suited for 
single-tasking operating systems. 


Multistaged processing/multitasking operating systems 


For a multitasking operating system to be interfaced with a BIOS, issues 
surrounding system throughput have to be handled more carefully than they 
are with a single-tasking operating system. The CPU must be free to pro- 
cess other tasks while a BIOS function is waiting for a hardware interrupt to 
occur. In order to do this, the BIOS must process functions in a way that 
minimizes BIOS control of CPU time. This is accomplished by processing 
function calls in multiple stages. 


Where the ABIOS fits in 


The ABIOS is written specifically for multitasking operating systems. As such, 
the ABIOS interface and the methods ABIOS employs to process function 
Calls are specifically designed to minimize ABIOS control of processor time. 


continued 
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The ABIOS Processing Model, Continued 


Processing models 


The ABIOS and CBIOS methods of processing function calls are contrasted 


below: 


Complete 


SINGLE-STAGED FUNCTION 


When processing single-staged functions, 
the ABIOS performs input/output immedi- 
ately and returns to the operating system. 
ABIOS requests that can be completed with 
a minimum of processor time are executed 


in this way. 
Complete 


DISCRETE MULTISTAGED FUNCTION 


ABIOS functions that require a greater 
amount of processor time are processed in 
multiple stages. 


In discrete multistaged functions, the caller 


initiates input/output and returns to the op- 
erating system, moving from stage to stage 
until the function call is complete. Discrete 
multistaged functions are driven from stage 
to stage by an interrupt from the device 
being serviced or by the expiration of a 
function-requested time period. 


Start : Stage : 


Complete 


SINGLE-STAGED FUNCTION 


The CBIOS processes all function calls on 
the single-staged call/process/return mod- 
el. Once a CBIOS function is invoked, the 
processor is prevented from turning to 
other work until the function completes and 


returns. 


DISCRETE MULTISTAGED FUNCTION 


NOT SUPPORTED 


CONTINUOUS MULTISTAGED FUNCTION | CONTINUOUS MULTISTAGED FUNCTION 


When processing continuous multistaged 
functions, ABIOS initiates input/output and 
returns to the operating system. Continu- 
ous multistaged functions can be consid- 
ered “standing requests” in that they never 
reach a completion point. Like discrete 
multistaged functions, they are driven from 
stage to stage by a hardware interrupt at 
the expiration of a function-requested time 
period. 


NOT SUPPORTED 


continued 
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The ABIOS Processing Model, Continued 


What drives multistaged functions 
Multistaged functions are driven from stage to stage by either: 


= hardware interrupt or 
= elapse of a function requested period of time. 


Some multistaged functions are driven purely by hardware interrupt. Others 
are driven purely by time period. Others still are driven by some combination 
of both hardware interrupt and time period. 


Interrupt driven stages 


Each interrupt-driven ABIOS service is associated with one hardware interrupt 
level. The ABIOS assumes that all hardware interrupt handlers are under the 
control of the operating system. 


When a hardware interrupt occurs, the operating system must call the func- 
tion associated with the interrupt so that the interrupting condition can be 
serviced. The ABIOS resets the interrupting Condition at the hardware level. 
The operating system’s hardware interrupt handler must perform end-of- 
interrupt processing at the interrupt controller level. 


A service can have more than one active function request. When this hap- 
pens, the hardware interrupt handler calls each function until the ABIOS 
replies that the hardware interrupt has been serviced. 


Time period driven stages 


some ABIOS functions are driven from stage to stage by the elapse of a 
function—requested period of time. The ABIOS assumes that time-period 
stage handlers are under the control of the operating system. When the time 
period requested by the function expires, the operating system’s time period 
handler must call the given ABIOS function. 


continued 
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The ABIOS Processing Model, Continued 


Hardware interrupt stages and hardware time-out 


All hardware interrupt driven stages of a function indicate a maximum time 
(in seconds) to wait for the hardware interrupt. The ABIOS assumes that all 
hardware time-out handlers are under the control of the operating system. 
Should the hardware time-out period associated with a given interrupt driven 
function elapse, the operating system must call the ABIOS to terminate the 
function and reset the hardware. 


Hardware time-out vs. time period stages 


The terminology surrounding time-period driven stages and hardware time— 
out handling is similar. However, it is important not to confuse the process- 
ing associated with the hardware time-out handling and time-period stage 
handling. 


Hardware time-out handling is associated exclusively with those stages of a 

multistaged function that are driven by hardware interrupt and is designed to 
handle function termination cleanly. Execution of a time-out handling routine 
is symptomatic of a hardware error. 


Time—-period handling is associated with those stages of a multistaged func- 
tion that are driven by time periods. Execution of a time-period handling 
routine indicates the elapse of a function-requested time delay and should 
not be associated with a hardware error. 


continued 
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The ABIOS Processing Model, Continued 


How handlers call ABIOS functions: ABIOS Entry Routines 
Although we have mentioned that the various handlers under the control of 
the operating system must call ABIOS functions, we have not mentioned how 
this is done: Each ABIOS Service is associated with a set of function entry 
routines. There are three kinds of entry routines: 


= Start Routine 
The start routine associated with a service is called when a function is first 
started. 


= Interrupt Routine 
The Interrupt Routine associated with a service is called when the function 
interrupts or when a time period driven function requires servicing. 


= Time-out Routine 
The Time-out Routine associated with a service is called when a interrupt- 
driven function suffers a hardware time-out. 


To reduce caller overhead, the ABIOS also contains a set of Common Entry 
Routines: Common Start, Interrupt, and Time-—out Routines. The Common 
Entry Routines do some initial processing then transfer control to the entry 
routine tied to the specific service. 
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ABIOS Data Structures 


Introduction 


The ABIOS makes use of four kinds of data structures. Three of the struc- 
tures — the Function Transfer Table, the Device Block, and the Common 
Data Area are roughly analogous to the data structures found in the CBIOS. 


The fourth structure is a function-specific, parameter block, called the 
Request Block. The Request Block has no data structure analog in the 
CBIOS, but it provides the ABIOS with the same parameter passing Capability 
as is provided to the CBIOS by the processor’s register set. 


Each ABIOS data structure is defined further below. 


ABIOS Data Structures 


Function Transfer Table 


' Each ABIOS Service Is associated with one Function Transfer 

Function Table. Each Function ee Table cor a list be Cee i 

the Start, Interrupt, an me-out Routine associated with its 

Transfer Table ABIOS service, as well as a list of vectors to the start of each 
function contained in that ABIOS Service. 


Device. Block 


An ABIOS Service is usually associated with one Device Block. The 
Devi Block Device Block contains the interrupt level, the arbitration level, and 
evice BIoCc other information about the hardware device associated with a 
ABIOS device service. Some ABIOS services are associated with 
more than one physical instance of a device. When this is the case, 

that service is associated with more than one Device Block. 


Common Data Area 


The Common Data Area contains a list of pointers to the Function 
Common Transfer Table/Device Block pair associated with each ABIOS Serv- 
Data Area ice. Each pair of pointers In the table Is identified by a unique 
Logical ID. Logical IDs are assigned dynamically when the ABIOS Is 
Wes and are used by the caller as an index into the Common 

ata Area. 


Request Block 


Each ABIOS function is interfaced with the caller via a function-spe- 
Request cific structure called the Request Block. All input and output pa- 
Block rameters are passed between the caller and the ABIOS through the 
Request Block. Offset OCh of all Request Blocks is reserved for a 

function status Indicator called the Return Code. 


continued 
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ABIOS Data Structures, Continued 


ABIOS initialization 


The Common Data Area, all Function Transfer Tables, and all Device Blocks 
are initialized (with segment:offset pointers) as part of ABIOS real mode 
initialization. In bimodal operating environments, the operating system insures 
bimodal access to the ABIOS by initializing (in selector:offset format) a 
parallel Common Data Area and a parallel set of Function Transfer Tables. 


Once they are initialized, the Common Data Area, the Function Transfer 
Tables, and the Device Blocks stay resident in system RAM for as long as 
the ABIOS is in use. 


Request Block initialization 


Before a given ABIOS function can be started, the caller must initialize its 
Request Block. The Request Block associated with a function call stays 
resident in system RAM for the life of the call. Request Blocks associated 
with completed function calls can be reused, or the memory they occupy 
can be reallocated for some other purpose. 


Table: CBIOS/ABIOS analogs 


End users familiar with CBIOS structures and conventions may find the table 
of analogies below useful. 


Pass Parameters CPU Registers Request Block 
(bidirectional) (bidirectional) 


Identify BIOS service | Interrupt number Logical ID 


Locate BIOS service Interrupt vector table Logical ID index into 
Common Data Area 
Locate BIOS function Jump table internal to Vector in Function Trans- 
CBIOS code fer Table 
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ABIOS Initialization Facts — 


Introduction 


Initializing ABIOS is a matter of initializing ABIOS data structures that stay 
resident in system RAM for as long as the ABIOS is in use: The Common 
Data Area, the Function Transfer Tables, and the Device Blocks. ABIOS is 
initialized by the operating system in a five-step process involving both the 
CBIOS and the ABIOS. 


Key facts to remember 
= Before ABIOS can be initialized, CBIOS must be initialized and the operat- 
ing system must be booted. 
» ABIOS can only be initialized in the microprocessor’s real mode. 
. Initializing ABIOS means initializing the ABIOS data structures. 


» In bimodal environments, the operating system must initialize parallel sets 
of Common Data Areas and Function Transfer Tables. 


continued 


12 ABIOS for IBM PS/2 Computers and Compatibles 


ABIOS Initialization Facts, Continued 


ABIOS initialization flow 


ABIOS initialization flow is illustrated below. 


Initialization Flow 


STEP 1: Build System Parameters Table 


The operating system calls CBIOS INT 15h AH = 04h Build 
System Parameters Table. The CBIOS builds the System 
Parameters Table in system RAM. The table describes 
the system stack requirements, the number of devices 
installed in the system, and the entry points to the rou- 
tines used during the ABIOS Calling Convention. 


CBIOS INT 15h 
AH=04h 


Build System 
Parameters Table 


STEP 2: Build ABIOS Initialization Table 


The operating system calls CBIOS INT 15h AH = 05h Build 
Initialization Table. The CBIOS builds the Initialization Table 
in system RAM. The table defines the information used to 
initialize the Device Block and Function Transfer Table 
associated with each ABIOS device. 


CBIOS INT 15h 
AH=05h 


Build Initialization 
Table 


STEP 3: Build Common Data Area 


The operating system allocates system memory for the 
Common Data Area, Device Blocks, and Function Transfer 
Tables. The operating system builds the Common Data 
Area, initializes all Device Block and Function Transfer 
Table pointers, and assigns Logical IDs. 


Buiid Common 
Data Area 


STEP 4: Initialize DBs and FTTs 


The operating system calls the ABIOS to initialize the 
Device Block (DB) and Function Transfer Table (FTT)as- 
sociated with each ABIOS service. The Common Data 
Area, Device Blocks, and Function Transfer Tables reside 
in RAM for as long as ABIOS is active. 


Build: 
Device Blocks 
Function Transfer 
Tables 


STEP 5: Build Protected Mode Structures 


In bimodal or protected mode environments, the operating 
system must build protected mode versions of the Com- 
mon Data Area and Function Transfer Tables. This proc- 
ess converts real mode segment:offset pointer to pro- 
tected mode selector:offset format. 


Build Protected 
Mode: 
Common Data 
Area Function 
Transfer Tables 
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ABIOS Initialization Facts, Continued © 


Data structure relationships 


The graphic below shows how the ABIOS Data Structures relate to each 
other once they have been initialized. 


Data Structure Relationships 


Common ABIOS Service 
Data Area 


@ 


Logical ID 
@ 
Device 
Block Pointers Lara 


Function 


Transfer Table 
Pointers Function 


Transfer Table . 


Oo 


Device Block 


iret 
Pointers Functions 


Hardware Device 


Legend 


Gd) The Function Transfer Table contains address pointers to each ABIOS function. 


(2) The Device Block is used by the ABIOS to store interrupt levels, device status Infor- 
mation, and hardware port addresses. 


(3) The Common Data Area contains a linked list of the Function Transfer Table and De- 
vice Biock pointer pairs associated with each service, as well as device memory Pols 
ers (if any) associated with the given device. | 
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Request Block Initialization 


Introduction 


Each ABIOS function is interfaced with its caller via a function-specific struc- 
ture called the Request Block. Before starting an ABIOS function the caller 
must initialize its Request Block. 


Physical device vs. logical device 


A hardware device is a device that physically exists in a system configura- 
tion. Physical devices are identified by a Device ID; for instance, all hard 
disks are associated with device ID 02h. Logical IDs, on the other hand, are 
used to reference individual device services. They are assigned dynamically 
at initialization, and their assignments will change when system configuration 
changes. The first device to be initialized will be assigned a Logical ID of 1; 
the second will be assigned Logical ID 2, and so on. 


Logical IDs are mandatory input 


Logical IDs are assigned to each ABIOS service during ABIOS initialization 
when the operating system builds the Common Data Area. A service’s 
Logical ID is used from then on as an index into the Common Data Area 
location where the service’s Function Transfer Table and Device Block point- 
ers are stored. A service’s Logical ID is a mandatory input into each function 
Request Block calling on that service. 


Request Block lifespan 


Once initialized, Request Blocks stay resident in system RAM for as long as 
the function call is active. That is to say, those Request Blocks associated 
with multistaged functions stay resident in system RAM for the life of the 
function. Request Blocks associated with completed functions may be 
reused, or the memory they occupy can be deallocated. 


continued 
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Request Block Initialization, Continued 


Rules governing Request Block use 
The general rules associated with Request Block use are illustrated below. 


INPUT Rules 


~ Request Block fields marked Reserved 
must be initialized to zeros. 


The content of input fields is not changed 
throughout a multistaged request. 


Initialize the Return Code to FFFFh before 
calling any ABIOS Start Routine. OUTPUT Rules | 


Output fields need not be 
initialized 


The contents of an output 
field must not be altered 


a rane ae sresies 
|00h_| Word | Request Block length _| ) 


Foch | Word | Timeout _— 
| Rules Governing 
ord | Data pointer 1 Request Block Reuse 


Request Blocks associated 
with completed functions 
can be reused. 


Reuse Request Blocks only 
if the Request Block 
Length for the new func- 
tions is the same or 
larger. 


Caching 


Bits 7-1 = Reserved 
Bit O = Caching 
0 Yes 


i No. 
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Transfer Conventions 


Introduction 


Once its Request Block has been initialized, the caller is free to transfer 
control to the ABIOS function. The process of transferring control to an 
ABIOS function is divided into two basic tasks: 


1. PUSH required entry pointers onto stack frame, and 
2. CALL the function entry routine. 


The difference between the two methods of calling ABIOS lies in the process 
used to locate pointers and load them onto the stack. 


Two tasks 
The graphic below details each control transfer task. 


Control Transfer Tasks 


PUSH POINTERS ON STACK STACK 
The caller pushes pointers to the Request 
Block and the Common Data Area onto the | “4— Pointer to Common Data Area 


stack. Depending on which convention is used q— Pointer to Request Block 
to transfer contro! to ABIOS, the caller may 4¢— Pointer to Function Trans. Table 
optionally push pointers to the Function Trans- 


fer Table and Device Block. oe eee 


TRANSFER CONTROL TO FUNCTION 


FUNCTION TRANSFER There are two kinds of function entry routines: 
ABL » Service-specific Entry Routines 
» Common Entry Routines 


By convention, control can be transferred to a 

‘ESO td given ABIOS function via either set of entry 

euncticn 00h routines. The ABIOS transfer convention indi- 

Function Oth cates that control be transferred to ABIOS 

| one ue the oe, ictal tia A 

perating System Transfer Convention indi- 

Function nnh Vector ——P! cates that control be transferred to functions 
via the Service-Specific Entry Routines. 


continued 
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Transfer Conventions, Continued 


ABIOS transfer convention 


In the ABIOS transfer convention, the operating system transfers control to 
the ABIOS function requested via the ABIOS Common Start Routine. From 
the caller’s point of view, the ABIOS Transfer Convention is the simpler of 
the two transfer conventions in that it reduces programming overhead when 
ABIOS functions are called in a bimodal environment. 


When using this method, the operating system: 
= builds the Request Block, 


=» pushes pointers to the Common Data Area and Request Block onto the 
stack, 

= pushes place holders for the Function Transfer Table and Device Block 
onto the stack, and 

= calls the ABIOS Common Entry Routine requested. When control is trans- 
ferred to the Common Entry Routine, the Common Entry Routine loads 
pointers to the Function Transfer Table and the Device Block onto the 
stack. The operating system then transfers control to the ABIOS service’s 
Service-Specific Entry Routine. 


Operating system transfer convention 


In the operating system transfer convention, the operating system transfers 
control to the function requested via the ABIOS service—specific routines. 


This transfer convention is more direct and may result in slight performance 
improvements. It is most effective when used to handle interrupts from 
programmed !I/O devices (such as the keyboard) that require peReates 
access to one function. 


When using this method, the operating system: 


= builds the Request Block, 


= pushes pointers to the Common Data Area, Request Block, Function 
Transfer Table, and Device Block onto the stack, and 


= calls the service-specific entry routine associated with the service/function 
requested. 
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ABIOS and Program Access 


Introduction 


For now, OS/2 is the primary operating system using ABIOS. OS/2 itself 
provides end user programs with powerful functionality which makes bypass- 
ing the operating system in favor of the ABIOS or hardware largely unneces- 
sary. However, the need may arise for the greater hardware control provided 
by direct access to ABIOS Services. 


The Anchor Pointer, OS/2, and program access 


When ABIOS is initialized under OS/2, the segment address of the Common 

Data Areas is stored by the operating system in a nonpublic variable called 
- the Anchor Pointer. Control cannot be transferred to an ABIOS function 

without first accessing the information contained in the Common Data Area. 


Therefore, access to the ABIOS is impossible from a program running under 
OS/2 unless it is supported by the operating system. Although it does not 
make the Anchor Pointer public, IBM OS/2 (versions 1.1 and beyond), sup- 
port program access of the ABIOS via calls to two DevHip services: ABIOS- 
CommoneEntry and ABIOSCall. 


Programmers who are not using IBM OS/2 should refer to their OS/2 docu- 
mentation to determine if their version of OS/2 supports direct access to the 
ABIOS. 
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Accessing ABIOS via ABIOSCommonEntry 


Description 


The IBM OS/2 service ABIOSCommonEntry is used to call an ABIOS func- 


tions via the ABIOS Transfer Convention, that is to say via the ABIOS Com- 
mon Entry Routines. 


ABIOSCommonEntry initializes the stack frame with pointers in the format 
required by the current processor mode. It then calls the Common Entry 


Routine specified in DH. On return, ABIOSCommonEntry cleans up the stack 
before returning to the caller. 


Caller must locate Logical ID 


Before invoking ABIOSCommonEntry, the caller must first initialize the Re- 
quest Block associated with the ABIOS function to be called. Since a serv- 
ice’s Logical ID is a mandatory input into each function Request Block, the 


caller is responsible for determining the Logical ID assigned to the service 
being called. 


Locating Logical ID via function Oth 


Because the Anchor Pointer to the Common Data Area is a nonpublic vari- 
able, the only way for the caller to determine a service’s Logical ID is to 


invoke function O1h, Return Logical ID Parameters, for each entry in the 
Common Data Area. 


To do this, the caller must use ABIOSCommonEntry to invoke function 01h, 
“Return Logical ID Parameters” for Logical IDs 03h to nnh. The Request 
Block associated with function 01h of each ABIOS service is fixed at 20h 
bytes. When called, function 01h returns to offset 12h the hardware Device 
ID associated with the service. From this value, the caller can determine 
which device service is linked to a given Logical ID. 


continued 


20 ABIOS for IBM PS/2 Computers and Compatibles 


Accessing ABIOS via ABlIOSCommonEntry, Continued 


ABIOS supported devices 


The ABIOS supports 16 kinds of physical devices. There is one ABIOS device 
service for each device. The table below lists the physical device ID and the 
ABIOS device services tied to those devices. 


Device ID | Device Type/Service Device ID | Device Type/Service 


ABIOS Internal Calls 
| 03h_sd| Video = EH | CMOSRRAM 
|___10h___| Programmable Option Select_ 
| 06h Serial Port | tth | Errortog 


Nonmaskable Interrupt i 


ABlIOSCommonEntry Input/Output 
Input: 
MOV SI, Request_Block Offset ; Offset in DS of Request Plock 


MOV DH, Which Com Routine * Indicate in DH which Common 
* Routine to call, where: 


* OOh = Common Start Routine 
; Olh = Common Interrupt Routine 
* O2h = Common Time-—out Routine 


MOV DL, DevHlp_ ABIOSCommonEntry 
CALL [Device Help] 


Output: 


CF OQ If call was successful 
1 If error occurred 
AX = Error Code | 

ABIOS not present. 


Unknown ABIOS command. 


continued 
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Accessing ABIOS via ABIOSCommonEntry, Continued 


To avoid suspension in the background 


ABIOS functions can sometimes be suspended if the operating environment 
is shifted from OS/2 mode to the DOS compatibility box. This can occur 
when functions executed in the DOS compatibility box put the service’s 


operating environment in a state that is unknown to the function called in 
OS/2 mode. | 


ROMCritSection sets a flag that prevents entry into the DOS compatibility 
box until the function called via ABLIOSCommonEntry has executed to com- 
pletion. Since there is no way to determine in advance whether or not a 
given function is susceptible to suspension, the caller has two choices: 


=» Call OS/2 ROMCritSection before calling ABLIOSCommonEntry, or 


‘= Test the function by calling it via ABLIOSCommonEntry and switching to 
the DOS compatibility box. 


lf ROMCritSection is called to prevent entry into the DOS compatibility box, 


then it must be called again after the ABIOS function completes to re-enable 
entry. | 


ROMCritSection Input/Output 


DS must point to the ABIOS Device Driver’s data segment. Reset DS if it has 
been previously used in a PhysTovVirt call. 


MOV AL, enter_or_exit ;Critical Section Flag 
>; = O exit 
; <> O enter 

MOV DL,DevHlp_ROMCritSection 

CALL [Device_Help] 


For more information 


For more information on calling ABIOS functions via ABLOSCommonEntry, 


refer to the IBM document /BM Operating System/2 Technical Reference 
Volume 7. | 
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Accessing ABIOS via ABIOSCall 


Description 


The IBM OS/2 service ABIOSCall is used to call an ABIOS functions via the 
Operating System Transfer Convention, that is to say via the ABIOS Service- 
Specific Entry Routines. 


ABIOSCall initializes the stack frame with pointers in the format required by 
the current processor mode. Then, it calls the Service-Specific Entry Routine 
specified in DH. On return, ABIOSCall cleans up the stack before returning 
to the caller. 


ABIOSCall Input/Output 


Input: 

MOV AX, LID -Service’s Logical ID 

MOV SI,RB Offset ;Data Segment DS offset to 
-caller’s Request Block 

MOV DH,Entry_ Point -Service-Specific Routine 
-OOh = Start Routine 
-Olh = Interrupt Routine 
;02h = Time-out Routine 


MOV DL,DevHlp ABIOSCall 
CALL [Device _Help] 


Output: 
CF 


O Call was successful 

1 Error occurred 

AX = Error Code 

ABIOS not present. 
Unknown ABIOS command. 


To avoid suspension in the background 


ABIOS functions can sometimes be suspended if the operating environment 
is shifted from OS/2 mode to the DOS compatibility box. To avoid this, the 
caller may occasionally be advised to call OS/2 ROMCritSection before 
calling ABIOSCommonEntry, as described on the previous page. 
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Return Code Handling 


Introduction 


ABIOS signals the status (Successful, unsuccessful, etc.) of a function call 
by returning a code to the Request Block for the operating system. 


The rules that the operating system must follow when handling this field are 
listed in the illustration below. 


| 00h | Word | Request Block Length | 
| 02h | Word || Logical ID 


_Unit 
| 06h [| Word || Function (0005h) 
| 08h_| Word || Reserved (initialize to 0000h) 
| 0An_| Word || Reserved (initialize to 0000h) _ | 
| OEh | 


a See Co 
| 10h | Word || Reserved (Initialize to 0000h) 


Return Code Field Rules 


Always initialize the Return Code field 
to FFFFh before initiating any ABIOS 
Start Routine. 


Because both a Start Routine and an Inter- 
rupt Routine may be operating on the same 
Request Block from different stack frames, 
the operating system should maintain a flag 
to indicate if a request has executed the 
Start Routine Return Code Field Bit Deter- 
mination code. If an interrupt occurs before 
the operating system determines the Re- 
turn Code for the Request Block, the flag 
indicates that the Interrupt Routine cannot 
be processed yet, since the Start Routine 
is not completed. If the operating system 
has determined the Return Code, interrupts 
can be processed, since the the Start Rou- 
tine is completed. 


During hardware interrupts, the oper- 


ating system should call the interrupt 
routine for each request on that inter- 
rupt level that has bit 0 Resume Stage 
after Interrupt set In the Return Code 
field until an interrupt is claimed (bit 2 
Not: My Interrupt is.returned clear). 


If there is an outstanding Request Block at 
interrupt time, the operating system must 
first see if the Return Code field is FFFFh. 
If it is, the operating system must not at- 
tempt to resume this request. The ABIOS 
can process the request and set the Return 
Code appropriately when the interrupt is 
executed. 


continued 
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Return Code Handling, Continued 


Return codes 


The following table contains a general listing of the ABIOS Return Codes. 
ABIOS may generate any value that can occur in a 16-bit ABIOS field, so all 
operating system routines that test ABIOS Return Codes should be prepared 
for any value (that is, each bit in the Return Code field should be tested). 


Description 


9000h-90FFh | Device Error | 
C000h 


Code 


0000h 
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ABIOS Extensions 


Introduction > 


Under OS/2, ABIOS data structure addresses and service/function entry 
points are only Known to the operating system. As such, enhancements to 
system software or hardware that require ABIOS extensions must insure that: 


=» The undefined interstage state information and work areas contained in 
the pre-existing service’s Device Block are not overwritten. 


= The extension maintains control of all function entry points, and 


= The extension will only be initialized if its revision level is greater than the 
revision level of the pre-existing service. 


Requirements for ABIOS extensions 


In order to satisfy the considerations listed above, all ABIOS extensions must 
meet the requirements outlined in the illustration below: 


Extension Requirement 1: File Header 


Service All ABIOS extension routines must be identified to 
Mike Code the system via an extension file header. 
Requirement 2: Routine to Build Initialization 


common Table Entry 


code ABIOS extensions must contain a routine that . 
can be called during the ABIOS initialization proc- 
start ess to build the extension’s entry into the ABIOS 
routine Initialization Table. 


entry int. Requirement 3: Routine to Build DB and FIT 


routines routine All ABIOS extensions must contain a routine to 
initialize an extension-specific Device Block (DB) 
time-out and Function Transfer Table (FTT). 


routine 


func. 1 : 
start Requirement 4: Service Code 


func. 2 Each ABIOS service must contain 


start «= A-complete set of extension-specific entry 
routines. 


function func. 3 _ = Run time code to service a device. 
starts start 


continued 


26 ABIOS for IBM PS/2 Computers and Compatibles 


ABIOS Extensions, Continued 


Two types of ABIOS implementations 


As long as it meets the four requirements for creating valid ABIOS exten- 
sions, an extension can be implemented either in ROM or in RAM. 


The differences between the two types of implementations are described 
below. 


ROM extension ABIOS ROM extensions: 


Exist in the same peripheral card ROM that contains 
their CBIOS counterparts. 


Contain manufacturer-specific ABIOS device services. 


Are located and initialized as part of the overall ABIOS 
ROM initialization process. 


RAM extension ABIOS RAM extensions exist as files that will be located 
and initialized into system RAM during the overall ABIOS 
ROM initialization process. If they are to be implemented 
under OS/2, extension file names must be listed in the 


file ABIOS.SYS. The following facts apply: 


» ABIOS.SYS must contain a list of filespecs separated 
by either blanks or new lines. 


Both ABIOS.SYS and any files listed in ABIOS.SYS 
ie reside in the root directory of the OS/2 IPL 
volume. 


The files listed in ABIOS.SYS are loaded into memory 
in the order in which they are listed. 


The sector size of all RAM extension files must be a 
multiple of 512K. 


All ABIOS RAM extension files must have a .BIO 
extension. 


RAM extensions are loaded after ROM extensions. 


The ABIOS 
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Where to Find More Information 


Introduction 


This chapter outlines the major concepts and design features of the ABIOS. 
It is intended to leave the reader with a mental model of how the ABIOS 
works. The details of any concept or feature presented here can be found in 


subsequent chapters of this book. 


Where to find more information 


For more information on... 


ABIOS Services 
ABIOS Functions 
ABIOS Request Blocks 
ABIOS Data Structures 
ABIOS Function Processing 
ABIOS Request Types 
ABIOS Multitasking Provisions 
ABIOS Initialization 

ABIOS Bimodal Support 
ABIOS Extensions 
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Chapter 2 
Hardware Environment 


Overview 


introduction 


This chapter describes the hardware environment supported by the ABIOS. 


Note: The hardware environment described here also applies to the CBIOS 
portion of PS/2—compatible ROM BIOSs. 


Hardware overview only 


The hardware contained in IBM PS/2 and compatible systems provides the 
user with a rich and powerful computing environment. A precise description 
of each IBM PS/2 hardware component, however, is beyond the scope of 
this book. The material presented here is intended to give ABIOS users a 
general survey of the PS/2 hardware and is not intended to substitute for 
the hardware data sheet or documentation available from individual hardware 
manufacturers. 


continued 
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Overview, Continued 


ABIOS benefits 


By its very nature, the ABIOS is designed to isolate the user from direct 
manipulation of hardware |/O ports, registers, and control words. As such, 
the ABIOS provides a high level interface to hardware that is guaranteed to 
remain the same when hardware components change. 


This has a number of benefits: | | 
« If programs use ABIOS calls instead of reads and writes to hardware, they 
will be more portable across differing hardware environments. 


» Using the ABIOS services spares the programmer from having to master 
many details about hardware that may change. 


In this chapter 
The following hardware information is presented: 
» 80286/80386/80386SX Microprocessors 
» Math Coprocessors 
= Micro Channel 
» |/O Devices 
» System Time—Related Devices 
= CMOS RAM Service 
» DMA Controller 
» Programmable Option Select (POS) 
» Intel 8259A Programmable Interrupt Controllers 
« System Control Port Definitions 
» Power-On Password 
» NMI Mask 
» Hardware |/O Port List 
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80286/80386/80386SX Microprocessors 


introduction 


The ABIOS must be implemented in systems that employ the Intel 80286, 
80386SX, or 80386 microprocessor, an equivalent, or a superset. 


The table below lists the ABIOS microprocessor support. 


Processor Speeds 


6 to 20 MHz (80286); 6 to 33 MHz (80386, 
80386SX) 


Note: Currently verified range of supported 
speeds. 


Walt States 0 or 1 wait states 


Address Modes Real and protected address modes 
Note: See “Address mode support” below. 


Address mode support 


The ROM BIOS for IBM PS/2 and compatible systems can be addressed in 
both the real and the protected address modes of the microprocessor. 


This statement holds true for both the ABIOS and the CBIOS portions of the 
ROM BIOS. The difference between the ABIOS and the CBIOS portions of the 
ROM BIOS lies not in the modes under which they can be addressed but in 
the kind of operating systems each is designed to support. 


=» The ABIOS is designed specifically to support multitasking operating sys- 
tems (e.g. IBM OS/2) that execute exclusively in the microprocessor’s 
real mode, exclusively in protected mode, or bimodally — switching be- 
tween real and protected modes. 

= CBIOS is primarily designed to support single-tasking operating systems 
(e.g. MS-DOS) that execute exclusively in the microprocessor’s real 
mode. 
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Math Coprocessors 


Introduction 


The ABIOS can be implemented in systems that include an Intel 80287 or 
80387 math coprocessor (80387SX for 80386SX processors) or an equiva- 
lent math Coprocessor. 


Description 


The math coprocessor performs high speed arithmetic, logarithmic, and 
trigonometric floating point arithmetic calculations, permitting much speedier 
processing for mathematically intensive processes. 


The math coprocessor works in parallel with the microprocessor, allowing 
both to process instructions separately. See the user manual for the 
coprocessor for details about the extended data types, registers, and 
instructions available with this chip. 


Math coprocessor hardware interface 


The coprocessor operates in an asynchronous mode and can use the same 
clock generator as the microprocessor. It functions as an I/O device and can 
be accessed through I/O ports OOF8h, OOFAh, and OOFCh. 


The coprocessor BUSY signal tells the microprocessor that the coprocessor 
is operating.. The WAIT signal means that it is executing, and forces the 
microprocessor to wait until the Coprocessor is done. 


The coprocessor can operate in either the real or protected address mode. 
It is in real address mode after a power-on, a reset, or when returning from 
protected address mode. 


The math coprocessor generates an error signal which sets IRQ 13, and the 
BUSY signal from the coprocessor is then held in the BUSY state. The BUSY 
signal can be cleared by an I/O Write to I/O port OOFOh or by a write of zero 
to I/O port address OOFOh with bits 0-7 set to zeros, which also clears 

IRQ 13. 


continued 
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Math Coprocessors, Continued 


ABIOS: INT 75h Numeric exception error handling 


IRQ 13 (which is generated by a math coprocessor numeric exception error) 
is vectored to INT 75h hardware interrupt service routine as part of the 
ABIOS initialization. When IRQ 13 goes high, INT 75h clears the BUSY signal 
and issues a software interrupt, INT 02h. 


Note: User programs which enable numeric exceptions must provide a 
method for intercepting and processing either INT 75h or INT 02h. 


Micro Channel 


Introduction 


The ABIOS supports such IBM Micro Channel-compatible features as Pro- 
grammable Option Select (POS) and configurable Direct Memory Access 
(DMA) arbitration levels. 


The following table lists the Micro Channel hardware supported by the ABIOS: 


Feature Description 

1/O address width is Allows either 8—bit or 16-bit I/O transfers. 

8-bit or 16-bits. 

Central arbitration Arbitrates among as many as 15 devices. 

control point. 

8 DMA channels. Serial DMA protocol for 8 channels; either 8-bit or 16-bit 
DMA transfer. | 

Level—sensitive Interrupt controller operated in level-triggered mode to 

interrupts. allow devices to share interrupt levels. 

Programmable option Eliminates need for jumpers and configuration switches. 

selec 

Channel extension Support future growth and additional channel features. 

connectors 

No support for Supports only adapters designed for the Micro Channel. 

PC-type adapters. 


continued 
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Micro Channel, Continued 


Micro Channel connectors 
The ABIOS supports three types of channel connectors: 
= 16-bit, made up of an 8-bit section, and a 16-bit extension, 
=» 16-bit with auxiliary video extensions, and 
= 32-bit connectors in Intel 80386-—based systems. 


Programmable option select (POS) 


POS data is accumulated in adapter description files (ADFs) which are cre- 
ated by adapter manufacturers for each adapter. The reference diskette 
supplied with MCA-compatible systems reads .ADF files and stores configu- 
ration information in CMOS RAM. The ABIOS power-on self test (POST) 
reads CMOS RAM and writes the configuration information to the POS regis- 
ters of the adapters. 


The POS. 1/O addresses are 0094h — 0097h and 0100h — 0107h. 
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/O Devices: Introduction 


The ABIOS supports the following I/O devices: 

= a diskette controller, 

= a fixed disk controller, 

» a VGA video controller, 

® an Intel 8042 or equivalent keyboard controller, 
= a serial port, and 

= a parallel port. 


Each of these capabilities is discussed below. 


I/O Devices: Diskette and Disk Hardware 


Diskette controller 
The ABIOS supports an NEC 765 or equivalent diskette controller. Four types 
of diskette drives are supported: 
» 720K 3.5-inch, 
=» 1.44 MB 3.5-inch, 
# 360K 5.25-inch, and 
» 1.2 MB 5.25-inch drives. 


Diskette drive configuration 


The ROM BIOS supports a maximum of two diskette drives. 


Fixed disk controller 


The ROM BIOS supports up to two fixed disks. The ABIOS supports an 
ST506 fixed disk adapter or equivalent. This adapter should be PS/2-—compat- 
ible. The ST506 adapter is single-tasking and must complete one operation 
before starting another, even though the next operation may be for the other 
fixed disk. The hardware interrupt request for fixed disk is 14. 


RLL and ESDI fixed disk controllers are also supported by the ABIOS. 


Hardware Environment 
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I/O Devices: Video Hardware 


Introduction 


The ABIOS video service supports IBM VGA-compatible hardware, including: 

» a VGA-compatible chip or chip set that includes a: 
=» CRT Controller 

Sequencer | 

= Graphics Controller, and 

Attribute Controller 

# DAC chip — INMOS G171 or compatible Digital-to-Analog Converter 

» Video RAM — 256K of dynamic read/write RAM configured as four 64K 
maps | 

» Monochrome or color direct drive analog monitor 

=» Monochrome or color multiple sync frequency monitors 


VGA-compatible chip (or chip set) 
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The VGA chip (or chip set) provides all CRT control signals. It consists of 
four components: CRT Controller, Sequencer, Graphics Controller, and 
Attribute Controller. 


The function of each VGA component is summarized in the table below. 


Function CRT Controller 
CRT Controller Generates horizontal and vertical CRT sync timings, 
cursor and underline timings, video buffer addressing, 
and refresh addressing. 


Sequencer Arbitrates system access to display RAM and fonts. The 
sequencer allows up to eight fonts with two fonts display- 
able at any one time. 

Graphics Controller Handles read/write operation on 4 parallel bit planes. 
Outputs data to Attribute Controller. 


Attribute Controller Converts Incoming text mode attribute data or graphics 
mode pixel data into 8-bit indices into the Digital-to- 
Analog Converter (DAC) color registers (see below). 


Note: For a complete description of VGA-compatible components, I/O 
ports, and registers, refer to the hardware documentation accompa- 
nying your particular VGA-compatible chip or chip set. 


continued 
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I/O Devices: Video Hardware, Continued 


DAC 


The video DAC contains 256 individual color registers which can be accessed 
by the BIOS as either four 64-color registers or sixteen 16-—color registers. 


Each DAC color register contains one 18-bit RGB analog value. Six bits of 
each register are allocated to each primary color. Thus, the color repre- 
sented in each DAC color register may be any of 256K possible colors 
(i.e. 23*6 = 256K). | 


Video RAM 


The ABIOS Video Service requires 256K of read/write video RAM formatted 
into four banks (or maps) of 64K. 


To maintain compatibility, display memory for each of the historical MDA, 
CGA, and EGA-compatible modes is mapped exactly as it was in the original 
display adapter. The display memory organization for the new VGA modes is 
Outlined in the ABIOS Video Services chapter. 


Analog monitor support 


To display all modes, the Video Service requires either a monochrome or a 
color direct drive analog monitor with a 31.5 KHz horizontal scan frequency. 


The display’s vertical gain is adjusted automatically by the VGA-compatible 
circuitry. Thus, video modes with 350, 400, and 480 horizontal scan lines 
, can be displayed without requiring manual adjustment. 


Multiscan monitor support 


In addition to 31.5 KHz direct drive analog monitors, the Video Service also 
supports multiscan rate monitors capable of operating in analog modes (e.g. 
NEC Multisync monitor). Monitors of this type require an adapter cable that 
matches the signal assignments and monitor ID circuitry of the DAC external 
video controller. | 7 
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I/O Devices: Keyboard Hardware 


Introduction 


The ABIOS supports an intelligent keyboard subsystem based on the Intel 
8042 or equivalent keyboard controller. 


The hardware interrupt level associated with the ABIOS Keyboard Service is 
IRQ 1. 


The 8042 controller chip 


The Intel 8042 peripheral controller (or compatible) is a single chip micro- 
computer that can be programmed to allow bidirectional communication 
between the master microprocessor and up to two auxiliary serial input 
devices. The 8042 chip, generally, is mounted on the system motherboard. 
8042 programs reside as firmware in the 8042 chip itself. 


Device support 


The kind of devices a given 8042 chip supports are dependent on how the 
8042 is programmed. 


On IBM PS/2-compatible systems, the 8042 is programmed to allow 
bidirectional communication between the system and the keyboard, as well 
as between the system and one other auxiliary serial device, such as a 
mouse, joystick, or trackball. 


Pointing device interface 


The pointing device in PS/2-compatible systems is controlled by the 8042. 
INT 74h handles interrupts from the pointing device. The ABIOS Pointing 
Device Service controls the device operations. 
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/O Devices: Parallel Port Hardware 


Introduction 


The ABIOS Parallel Port Service is associated with hardware interrupt request 
7. The ABIOS supports a parallel port that can transfer eight bits of data at 
standard TTL levels. The parallel port can be called port 1 through 8, must 


be IBM PS/2-compatible, and must have a bidirectional mode, Supporting 


both input and output. The parallel port also supports level—sensitive inter- 


rupts and a readable interrupt pending status. 


Parallel port addresses 


The following table lists the common parallel port addresses. Up to 8 parallel 


ports are supported. 


Parallel 
- Port Number Data Address Status Address Control Address 


0378h 0379h 037Ah 


Parallel port extended mode 


The extended mode of the parallel port can be selected through the port 
system-based POS registers. The extended mode adds a bidirectional 
interface. 
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/O Devices: Serial Port Hardware 


Introduction 


The ABIOS supports a National Semiconductor 16550 serial port controller or 
equivalent logic. The serial ports can be addressed as Serial 1-8. See 
(40:10h) to find out how many serial ports are available. Serial 1 and 3 
interrupts are on IRQ 4; Serial 2 and 4 interrupts are on IRQ 3. The serial . 
port base addresses are shown below. ABIOS initializes the serial ports in the 
same order that they reside in the ROM BIOS data area, so the serial port 
Logical IDs will be in the same order as in the BIOS Data area (40:10h). 
Additional serial ports and Logical IDs may be initialized. 


Serial port addresses/interrupt levels 


The serial port addresses and interrupt levels are listed in the table below. 


| Serial Port Number Base Address Interrupt Level 


NS 16550 characteristics 


The NS 16550, which is functionally compatible with the NS 16450 and the 
NS 8250, supports: 


» Characters of 5, 6, 7, or 8 bits, 
» 1, 1.5, or 2 stop bits, and 
=» even, odd, or no parity modes. 
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/O Devices: Serial Port Hardware, Continued 


NS 16550 Serial Communications Controller 


The NS 16550 does serial-to—parallel conversions on data received from a 
peripheral device or a modem, and parallel-to-serial conversion on data 
received from the system processor. The system processor can read the 
status of the NS 16550 at any time during its operation. The information 
furnished includes the type and condition of transfer operations in progress, 
as well as any error conditions (parity, overrun, framing, or break interrupt) 
present. The NS 16550 provides complete modem control, and has a user 
programmable processor-interrupt system. 


NS 16550 Serial Controller Registers 
The NS 16550 has 12 accessible registers: 
» Receiver Buffer Register (Read Only) 
» Transmitter Holding Register (Write Only) 
« Interrupt Enable Register (Read/Write) 
= Interrupt Identification Register (Read Only) 
» FIFO (First in/First out) Control Register (Write Only) 
» Line Control Register (Read/Write) 
« Modem Control Register (Read/Write) 
= Line Status Register (Read Only) 
= Modem Status Register (Read Only) 
= Scratch Register (Read/Write) 
= Divisor Latch (LSB) (Read/Write) 
=» Divisor Latch (MSB) (Read/Write) 


Information on the operation of these registers is contained in the National 
Semiconductor NS 16550 Data Sheet. However, to avoid any incompatibility 
problems introduced by direct hardware programming, use the access to the 
serial controller provided through the BIOS services. 


Programmable baud rate generator 
The serial port controller can operate at speeds of from 110 to 19,200 bps. 
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System Time-Related Devices: Introduction 


System time-related components 


The ABIOS supports that the following time—-handling chips, or their 
equivalents: 


= Intel 82284 Clock Generator 


» Intel 8254A Programmable Interval Timer (PIT) 
» Motorola MC146818A Real Time Clock 


System Time-Related Devices: 82284 Clock Generator 


Description 
The Intel 82284 (or compatible) Clock Generator chip interfaces directly to 
the system microprocessor (CPU). The 82284 chip: 
» Provides the CPU with two clock inputs 
=» Generates the READY input to the CPU 
» Synchronizes the system RESET input to the CPU. 
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System Time-Related Devices: 8254A PIT Chip 


Introduction 


The 8254A Programmable Interval Timer (PIT) is a counter and timer that 
provides three channel timers. All channels are driven by a 1.19 MHz oscilla- 
tor signal. Each “tick” of the PIT generates hardware interrupt request 0. 


The BIOS supports the Intel 8254A programmable counter chip or its equiva- 
lent. The timer chip need not include a timer/counter 1 but should provide a 
limited-function timer/counter 3. 


Timer channel differences 
There are some differences between the three timer channels. 


Counters O and 2: 

=» are independent 16-bit counters, 

= can be preset, and 

= can count in BCD (binary coded decimal) or in binary. 


Counter 3: 

= is only 8 bits, 

= can be preset, 

= counts in binary only, and 
=" can only count downward. 


System Timer Modes 


The system timer has six modes: 


Interrupt on Terminal Count 


i Se Hardware Retriggerable One-Shot 


Software Triggered Strobe 


Hardware Retriggerable Strobe | 


continued 
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System Time-Related Devices: 8254A PIT Chip, Continued 


Common timer mode operations 


All modes have the following operations in common: 


All control logic resets when control bytes are written to a counter. 
= Counters do not stop when they reach zero. | 


In Modes O, 1, 4, and 5 the counter wraps to the highest possible count, 
and continues to count. 


In Modes 2 and 3, the counter reloads the initial count and continues to 
count. 


Timer Channels 


The following table describes the functions of the timer channels. The sys- 


tem timer is treated as a series of I/O ports. Three are count registers, and 
two are control registers. | 


Description 


System Timer 
Tone Generation for Speaker 0042h 


Control Register 3 0047h 


8 

a 

ee aM 
ra 

as 


Watchdog Timer 


The Watchdog Timer is used to find out if IRQ 0 is not being serviced, which 
can be used to detect a user program in a tight loop. 


The Watchdog Timer is enabled or disabled by the CBIOS INT 15h, System 
Services, function C3h. 
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System Time-Related Devices: MC146818A RTC Chip 


Introduction 


The ABIOS supports a Motorola MC146818A Real Time Clock, or equivalent. 


This chip is assumed to have at least 64 bytes of nonvolatile CMOS RAM 


available to store configuration data. 


RTC CMOS RAM Addresses 
The following table lists the CMOS RAM addresses: 


0070h 1 Byte CMOS RAM address, where: 

Bit 7 = 1 NMI disabled 

Bits 6-0 = 0 CMOS RAM address 
0071h CMOS RAM data port 


= To write to CMOS RAM: 
= Inhibit interrupts. 


# Write the CMOS address to which the data is to be written to I/O 
port 0070h. 


» Write the data to be written to I/O port 007th. 


= To read from CMOS RAM: 
« Inhibit interrupts. 


» Write the CMOS address from which the data is to be read to I/O 
Port 0070h. 


» Read from 1/O port 007th. 
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CMOS RAM Service 


Introduction 


Information may be stored in up to two areas of CMOS RAM. The table 
below describes the CMOS RAM areas available to the ROM BIOS. 


Table of CMOS RAM areas 


The) | | | | 


CMOS RAM | 0070h and 64 bytes} These bytes are located on the Motorola 
Data Area 0071h | MC146818A Real Time Clock CMOS chip 
| (or its equivalent). All implementations 
of the BIOS make use of this area to 
store real time clock, POST, and sys- 
tem configuration data. 


Extended 0074h, 0075h, When implemented on systems that em- 

CMOS RAM | and 0076h ploy more than four adapter slots, the 

Data Area BIOS requires an additional 2K of CMOS 
RAM. This extended CMOS RAM is pri- 
marily used to store POS data. 
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DMA Controller 


DMA functionality 


The hardware environment for DMA transfers is described here in order to 
explain the background against which the DMA ABIOS functions operate. The 
ABIOS, however, serves as a shield between underlying hardware and re- 
quests of the operating system, obviating the need for the caller to directly 
access the DMA controller. 


Direct Memory Access (DMA) allows large amounts of data to be transferred 
from a physical device to system memory or vice versa without micropro- 
cessor involvement. A program may initiate a DMA transfer and have no 
need to copy each byte or word individually, freeing the processor for more 
complex tasks. DMA transfers are typically from/to a fixed I/O port address 
to/from a continually incremented memory address. 


DMA functionality in Micro Channel systems is a superset of the functionality 
of two Intel 8237 DMA Controllers, one addressed at every port, starting with 
Port OO0Oh, and one addressed at every other port, starting at port OOCOh. 
Access to 8237—compatible DMA functions and to additional functions for al/ 
channels is provided at I/O ports 0018h and 001Ah. Data output to port 
0018h selects the channel and function, and data output to or input from 
001Ah goes to or from the selected internal register. 


Bus sharing 


The system microprocessor and any currently-transferring DMA users can 
share the bus by taking turns directing bus cycles (driving the Micro Chan- 
nel’s address lines and certain control signals). An arbitration process deter- 
mines which of these possible bus masters are ready to direct a cycle. 
Competing bus masters (DMA devices) are assigned varying priorities, which 
are weighed during arbitration. Each bus master gets control of the bus for a 
number of cycles as determined by the arbitration process. 


DMA device 


A DMA device (or bus master) is one that enters into arbitration for the 
channel. If it wins, it receives addresses and control signals from the DMA 
controller so it can read or write data. 


continued 
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DMA Controller, Continued 


DMA Controller functions 


A DMA controller is a device which monitors the arbitration process and 
gives addresses and control signals to the device that has won the bus 
through arbitration. The controller does not enter into the arbitration itself. 
PS/2-compatible Micro Channel—based systems provide a DMA controller 
that supports DMA transfers to/from up to eight devices at once. 


DMA hardware registers 


The DMA controller maintains several hardware registers for each DMA 
channel. The key registers are: 


" a memory address where the next byte or word will be transferred to 
or from 


= a count of the remaining bytes to transfer (transfer count) 

= a flag (mode) controlling the transfer direction (to memory or to the 
device), and | | 

= transfer status flags for each channel (status) 


continued 
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DMA Controller, Continued 


DMA hardware registers 
The DMA Controller has ten sets of registers, summarized below: 


Number of 
Register Size (bits) Registers How Allocated 


Memory Address 1 per Channel 


1/O Address 1 Per Channel 
Transfer Count 1 Per Channel 
Temporary Holding All Channels 


1 for Channels 7-4 
1 for Channels 3-0 
1 for Channel 4 
1 for Channel 0 


1 for Channel 3-0 


Status 


Mode Control Field 


The Mode Control field provides an opportunity for the caller to use the 
Autoinitialization and Programmed I/O (PIO) features of the DMA Controller. 


= Autoinitialization 


Specifies if the DMA Controller will initialize automatically wnen the transfer 
reaches the terminal count. 


= Programmed I/O 


Specifies that the I/O address is to be programmed to the DMA Control- 
ler, driving the 1/O address on the bus during the DMA cycles. 


continued 
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DMA Controller, Continued 


Transfer Control Bytes 


These fields provide an opportunity for the caller to specify the physical 


address of the memory and |/O fields for ABIOS DMA Service functions 10h, 
11h, and 12h. 


= Count Control 


Specifies if the physical address is decremented or incremented during 
a transfer. | 


= Device Size | 
Specifies whether this is an 8-bit or 16-bit transfer. 


DMA controlled by microprocessor 


The microprocessor can address the DMA controller and access the DMA 
registers. The microprocessor can control the DMA modes, transfer ad- 
dresses, transfer counts, channel masks, and page registers. 


Direct DMA Controller access 


Reading directly from or writing directly to any DMA Controller port may cause 
unpredictable results. 


DMA data transfer 


After a DMA device has won the arbitration bus and the DMA controller is 
programmed to service the request, a transfer can take place. 

DMA transfers can be: 

= single transfer, 

=» multiple transfer (burst mode), or 

» read verification. 


continued 
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DMA Controller, Continued 


Burst mode 


Burst mode is a method of DMA transfer that allows a device to remain 
inactive for long periods and then send large amounts of data in a short 
time. Some peripheral devices, e.g. a fixed disk, transfer their data in bursts 
that are frequently separated by long periods of inactivity. Burst mode is a 
way of making these devices more efficient. The device asks to be serviced 
only when it has data to transfer and then does so in large quantities. 


Arbitration levels 


Arbitration is a process through which devices compete for control of the 
Micro Channel on a prioritized basis. Arbitration levels are predefined or 
programmable levels of priority assigned to devices that compete for pos- 
session of the channel. 


Central Arbitration Control is a hardware function that allows intelligent pe- 
ripherals to share and control access to the system. Arbitration is organized 
in levels of priority, and on each level there can be a number of competing 
devices. 


Arbitration Levels are numbered from OOh to OFh. In addition, there are 
Arbitration Levels -1 and -2, which exist only on the system board. Of the 
former set, Arbitration Level OOh has the highest priority; Level OEh has the 
lowest. All arbitration level priorities are assigned sequentially; OOh through 
OEh are the highest through lowest priorities. Level OFh is reserved. 


Note: The ABIOS DMA service reads the fixed disk arbitration level from the 
CBIOS extended data area at ABIOS initialization and uses this arbitra- 
tion level throughout the ABIOS session. 


continued 
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DMA Controller, Continued 


Arbitration levels, cont’d 


The following table summarizes the arbitration levels: 


Arbitration Levels Primary Assignment | | 


a 
SS 
a 


Reserved 


Reserved 


System Microprocessor 


* These DMA Channels can be programmed to any arbitration level 


ABIOS functions allow these arbitration levels to be allocated, deallocated or 
disabled. 
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DMA Controller, Continued 


DMA channel flags 
Additional channel flags control whether 


= a transfer is to be repeated forever, 
= the memory address is to be decremented or incremented after 
each cycle, 


» the DMA controller maintains I/O address (this is hardwired in most 
devices that use DMA), or 


= a byte or a word is transferred at each cycle. 


Physical and Virtual DMA channels 


DMA channels can be either physical or virtual. A physical channel can only 
have one arbitration level, but a virtual channel can be programmed to own 
any arbitration level not currently assigned to a different channel. Thus, a 
virtual DMA channel can have many arbitration levels. 


Functionally, there is no difference between physical and virtual channels. 
Priority is determined by the arbitration level only, where level OOh is the 
highest priority and level OEh the lowest. 


Virtual DMA Channels and the Arbus register 


The arbitration level assignment for channels 0 and 4 can be programmed 
using the two 4-bit Arbus registers. The Arbus registers permit dynamic 
reassignment of the arbitration ID value by which the DMA controller re- 
sponds to DMA requests for bus arbitration. Channels 0 and 4 can then 
service devices at any arbitration level. 
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DMA Controller, Continued 


DMA Channels 


The DMA channel I/O addresses are defined in the I/O Port Address section 
later in this chapter. They range from O000h — OOOFh, 0018h, 001Ah, O081h 
- 008Fh, and 00COh - OODEh. 


DMA extended mode 


An extended mode register is available for each programmable DMA channel 
and is used when a DMA channel requests a DMA data transfer. DMA chan- 
nels must match the transfer size of the DMA slave, which is programmed 
by Bit 6 of the extended mode register. DMA read transfers of 16 bits from 
8-bit memory or 8—-bit memory-mapped I/O devices are not supported. 


The following table describes the DMA extended mode register: 


Bit Number Description a 


= 0 Reserved 


= 0 8-bit transfer 
= 1 16-bit transfer : 


= 0 Reserved 


= 0 Reserved 


= 0 Read memory transfer 
= 1 Write memory transfer 


= 0 Verify 
= 1 Transfer data 


= 0 Reserved 


0 1/O address OOh 
1 User programs the I/O address 
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Programmable Option Select (POS) 


Introduction 


Because it is an integral part of the Micro Channel Architecture (MCA), 
Programmable Option Select support is assumed. 


Adapter slots 


The ABIOS supports up to eight adapter cards (or more on systems with a 
customized BIOS). The ABIOS will work with any system regardless of the 
number of adapter slots available. 


Adapter card Identification 


Each adapter card must have a unique 2-byte identifier. 


Adapter description files 


POS data is accumulated in adapter description files (ADFs) that are created 
by adapter manufacturers for each adapter. The reference diskette supplied 
with MCA-compatible systems reads the .ADF files and stores the configura- 
tion information in CMOS RAM. This information is read by the BIOS power- 

on self test (POST), which writes it to the POS registers of the adapters and 
the system board. 
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Intel 8259A Programmable Interrupt Controllers 


Introduction 


The ABIOS supports two cascaded Intel 8259A Programmable Interrupt Con- 
troller (PIC) chips, or their functional equivalent. 


Description 


The PIC handles all maskable hardware interrupts. The ABIOS insures com- 
patibility with hardware interrupts expected by existing software. Formerly 
reserved, IRQ2 is now associated with the 8042 Auxiliary Device (mouse) 
controller. | 


Levels of Interrupt 


There are 16 levels of interrupts. Interrupts are level—sensitive, allowing 
several devices to share the same hardware interrupt. This reduces the 


interrupt controller’s sensitivity to a transient signal on the Micro Channel 
bus. | | 


Programmable Interrupt Controller Addresses 
The following table lists all PIC addresses: 


ala [eth [moms [ERA [ne 
Address Equivalents IRQs Routed Status Description 
(2th | master azsoa[ inao-mna7 | w | Mask 
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Intel 8259A Programmable Interrupt Controllers, Continued 


Table of IRQ assignments 


The following table shows the assignment of interrupt requests to commonly 
interrupting devices, listed from highest to lowest priority. Other devices 

not listed may use interrupt requests and may share requests with these 
devices. 


[noo tere 
[rat | Keyboard 


Redirect cascade 


Reserved 


80x87 math coprocessor exception 
a Fixed disk controllers 


Serial port 2 
Serial port 1 


Parallel port 2 
Diskette 


Parallel port 1 
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System Control Port Definitions 


Introduction 


The ABIOS supports certain system control functions at I/O Port addresses 
O061h and O092h. 


Port 61h: System Control Port B 


The read/write definitions for I/O port address O061h, System Control Port 
B, are: 


Port 61h: Write Operations 
Description 


| = 1 Reset timer 0 output latch (IRQ 0) 
a ae = 0 Enable channel check 


= 0 Enable parity check 
= 1 Speaker data enable 


= 1 Enable Timer 2 gate to speaker 


ek —Descrntion 
a 
Se 
= Toes win ach rotreahreavest 
8 
—— 
a 


= 0 Channel check enabled | 
= 0 Parity check enabled 
= 1 Speaker data enabled 


= 1 Timer 2 gate to speaker enabled 
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System Control Port Definitions, Continued 


Port 0092h: System Control Port A 


I/O port 0092h (R/W), System Control Port A, contains system control flag 
data. System control Port A is defined below: 


Description 


ee 
5 _ [0 Reserved rust be z0ro) 
[4 [t= Watonog teow occured 
i 
a re 
ae a 
a 


Hardware Environment 


Power-On Password 


There are eight bytes in CMOS RAM reserved for a 1-7 byte password and a 
check character for that password. The microprocessor accesses these 
bytes during POST. These bytes cannot be accessed by a user program. 


These eight bytes are initialized to zeros and are changed to the password 
during password installation. Passwords can only be changed during POST 
via the program on the reference diskette which is supplied with MCA- 
compatible systems. : 


Models 25 and 30: Power-on password is not supported in IBM PS/2 Models 
25 and 30, and compatibles. 


NMI Mask 


The NMI (nonmaskable interrupt) input to the microprocessor is masked off 
at power-on reset. Bit 7 of I/O address 0070h is set to zero to enable the 
NMI. A power-on reset sets this bit to one. 
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Hardware I/O Port List 


Table: Hardware I/O Port Definitions 


Read/Write 
1/O Address Status Description 


[oon [RW | OMA chanel, tanto cour ogster 
[008 [RW [OMA cane anater count reer 
R/W ' 
WwW ; 


[s00an | __RIW__| DM channel 2, memory address register 
[cosh [Rw | OMA camel 2, ranefor count register 


DMA channel 0-3, status register, where: 


Bit 7 = 1 Channel 3 request 
Bit 6 = 1 Channel 2 request 
Bit 5 = 1 Channel 1 request 
Bit 4 = 1 Channel 0 request 
Bit 3 = 1 Terminal count on channel 3 
Bit 2 = 1 Terminal count on channel 2 
Bit 1 = 1 Terminal count on channel 1 
Bit 0 = 1 Terminal count on channel 0 


DMA channel 0-3, mask register, where: 


Bits 7-3 = 0 Reserved 
Bit 2 = 0 Clear mask Bit 

= 1 Set mask Bit 
Bits 1-0 = 00b Select channel 0 
oor Select channel 1 
1 


Ob Select channel 2 
1b Select channel 3 


DMA channel 0-3, mode register, where: 


Bits 7-6 = 00b Demand mode 
= 01b Signal mode 

Ob Block mode 

1b Cascade mode 


Bits 5-4 Reserved 

Bits 3-2 Ob Verify operation 
1b Write operation 
1b Reserved 

Bits 1-0 Ob Select channel 0 


ib Select channel 1 
Ob Select channel 2 
1b Select channel 3 


1 
1 
0 
0 
0 
et Read operation 
0 
0 
1 
1 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’ d 


Read/Write 
1/O Address Status Description 


000Eh DMA Channel 0-3 Clear Mask Register 


O0OOFh W DMA channel 0-3, write mask register, where: 
Bits 7-4 = 0 reserved 
Bit 3 = 0 unmask channel 3 mask bit 
0018h 
OEh-OFh Reserved 
Bits 3-0 = 0 Reserved 


Bit 2 = 0 unmask channel 2 mask bit 
_= 1 set channel 2 mask bit 

Bit 1 = 0 unmask channel 1 mask bit 
= 1 set channel 1 mask bit 

Bit O = 0 unmask channel 0 mask bit 


= 1 set channel 0 mask bit 


DMA extended function register, where: 


Bits 7-4 = Progress command, where: 
00h I/O address register 
Oth Reserved 
02h Memory address register write 
03h Memory address register read 
04h Transfer count register write 
05h Transfer count register read 
06h Status register read 
07h Mode register 
08h Arbus register 
09h Mask register set single bit 
OAh Mask register reset single bit 
OBh-OCh Reserved 

~ ODh Master clear 


grammed by Operation Command Word 3 
(OCW3): 


Interrupt request register, where: 


Bits 7-O= 0 No active request for the cor- 
responding interrupt line 

= 1 Active request for the correspond- 
ing interrupt line 


Interrupt in-service register, where: 
Bits 7-G= 0 The corresponding interrupt line is 


= 1 set channel 3 mask bit 
DMA extended function execute register 

0020h PIC, Interrupt request/in-service registers pro- 

not currently being serviced 
= 1 The corresponding interrupt line is 
currently being serviced 
continued 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
I/O Address Status Description 


0020h WwW PIC, Initialization Command Word 1 (ICW1) (Bit 
4 is one), where: 
Bits 7-5 = 000 Only used in 80/85 mode 
Bit 4 = 1 Reserved 
Bit 3 = 0 Edge triggered mode 
= 1 Level triggered mode 
Bit 2 = 0 Successive interrupt vectors are 
separated by eight bytes 
= 1 Successive interrupt vectors are 
separated by four bytes 
Bit 1 0 Cascade mode 
1 Single mode — no ICW3 needed 
Bit O 0 No ICW4 needed 
1 ICW4 needed 


0021h PIC, ICW2, ICW3, or ICW4 in sequential order 


after ICW1 written to Port 0020h 


ICW2, where: 


Bits 7-3 = Address lines A0O-A3 of base vector 
address for interrupt controller 
Bits 2-0 = 000 Reserved 


ICW3, where: 


Bits 7-0 = 0 Slave controller not attached to 
corresponding interrupt pin 
= 0 Slave controller attached to 
corresponding interrupt pin 


iCW4, where: 


Bits 7-5 = 000 Reserved 
Bit 4 = Q No special fully-nested mode 
= 1 Special fully-nested mode 
Bits 3-2 =00 Non-buffered mode 
= 01 Non-buffered mode 
= 10 Buffered mode/slave 
11 Buffered mode/master 
0 Normal EOI 
1 Auto EOI 
: 


80/85 mode 
8086/8088 mode 


PIC, Interrupt mask register (OCW1), where: 
Bit 7 = 0 Enable parallel printer interrupt 


0021h R/W 
Bit 6 = 0 Enable diskette interrupt 
Bit 5 = 0 Enable fixed disk interrupt 
Bit 4 = 0 Enable serial port 1 interrupt 
Bit 3 = 0 Enable serial port 2 interrupt 
Bit 2 = 0 Enable video interrupt 
Bit 1 = 0 Enable keyboard interrupt 
Bit O = 0 Enable timer interrupt 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont'd 


Read/Write — 
VO Address Status | Description 


PIC, ocw2 (Bit 4 is zero, Bit 3 is zero), where: 


Bits 7-5 = 000 Rotate in automatic EOI mode 
(clear) 
= 001 Non-specific EOI 
= 010 No operation 
= 011 Specific EOI 
100 pos in automatic EOI mode 
set 
= 101 Rotate on non-specific EOI 
command — 
= 110 Set priority command 
= 111 Rotate on specific EOI 


command 
Bit 4 = 0 Reserved 
Bit 3 = 0 Reserved 
Bits 2-0 = Interrupt request to which the 


command applies 


| PIC, OCW3 (Bit 4 is zero, Bit 3 is one), where: 


Bit 7 = 0 Reserved 
Bits 6-5= 00No operation 
| 01No operation 
10 Reset special mask 
11 Set special mask 


Bit 4 = 0 Reserved 

Bit 3 = 1 Reserved 

Bit 2 = 0 No poll command 
= 1 Poll command 

Bits 1-O= 00No operation 


= 01No operation 

= 10Read interrupt request register 
on next read at Port 0020h 

= 11 Read interrupt in-service register 

on next read at Port 0020h 


Programmable Interrupt Timer - Read/write 
counter 0 


Programmable Interrupt Timer - Read/write 
counter 2 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont'd 


Read/Write 
1/O Address Status Description 


0043h WwW PIT, control word register for counters 0 and 
2, where: 
Bits 7-6 = 00b Select counter 0 
01b Reserved 
10b Select counter 2 
Bits 5-4 = 00b Counter latch command 
= 01b deta counter bits 0-7 
only 
= 10b Aisera pelea counter bits 8-15 
only 
= 11b Read/write counter bits 0-7 
first, then bits 8-15 
Bits 3-0 = 000b Mode 0 select 
= 001b Mode 1 select 
= X10b Mode 2 select 
= X11b Mode 3 select 
= 100b Mode 4 select 
= 101b Mode 5 select 
Bit 0 = 0 Binary counter 16 bits 
= 1 Binary coded decimal counter 


0044h —2 PIT, read/write counter 3 


PIT, control word register for counter 3, where: 
Bits 7-6 = 00b Select counter 3 


Bits 5-4 = = 00b Counter latch command 
select counter 0 
= 01b Read/write counter bits 0-7 
only 
Ob Reserved 
1b Reserved 


ah ach 


System control port B, where: 


Bit 7 = 1 Parity check 

Bit 6 = 1 Channel! check 

Bit 5 = 1 Timer 2 output 

Bit 4 = 1 Toggle with each refresh request 
Bit 3 = 0 Channel check enabled 

Bit 2 = 0 Parity check enabled 

Bit 1 = 1 Speaker data enabled 

Bit 0 = 1 Timer 2 gate to speaker enabled 
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Hardware 1/O Port List, Continued 


Table: Hardware |/O Port Definitions, cont’d 


Read/Write | 
1/O Address | Status Description 


0061h WwW System control port B, where: 
Bit 7 = 1 Reset timer 0 output latch (IRQ 0) 
; Bits 6-4 = Reserved 
Bit 3 0 Enable channel check 
Bit 2 0 Enable parity check 
Bit 1 1 Speaker data enable 
- Bit 0 1 Enable timer 2 gate to speaker 


0064h 8042 Commands | 


8042 Status, where: 


Bit 7 = 1 Parity error 

Bit 6 = 1 General time out 

Bit 5 = 1 Auxiliary output buffer full 
Bit 4 = 1 Inhibit switch 

Bit 3 = 1 Command/data 

Bit 2 = System flag 

Bit 1 = 1 Input buffer full 

Bit 0 = 1 Output buffer full 


CMOS RAM address register port, where: 


Bit 7 = 1 NMI disable 
= 0 NMI enabled 
Bits 6-0 = 0 CMOS RAM address 


0074h WwW Extended CMOS RAM address register port, 
least significant byte. 
0075h | Ww _ Extended CMOS RAM address register port, 
. most significant byte | | 
0076h Extended CMOS RAM data register port 


_oo8oh | RR | MAaccoss 
0081h ar ee DMA channel 2, page table address register 
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Hardware I/O Port List, Continued 


Table: Hardware ie) Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


DMA arbitration register, where: 


Bit 7 = 1 System microprocessor cycles 
enabled 

Bit 6 = 1 Arbitration mask by NMI 

Bit 5 = 1 Bus timeout 

Bit 4 = 0 Reserved 


Bits 3-0 = Arbitration level 


DMA arbitration register, where: 


Bit 7 = 1 Enable system microprocessor 
cycle 

Bit 6 = 1 Arbitration mask 

Bit 5 = 1 Enable extended arbitration 


Bits 4-0 = 0 Reserved 


DMA card selected feedback register, where: 


Bits 7-1 = Reserved 
Bit 0 1 Card selected feedback signal 
active on previous cycle or 
system board |/O functions 
accessed by an I/O cycle 


System control port A, where: 


Bit 7 = 1 Fixed disk activity light bit A on 
Bit 6 = 1 Fixed disk activity light bit B on 
Bit 5 = X Reserved 

Bit 4 = 1 Watchdog timeout occurred 
Bit 3 = 1 Security lock latch locked 

Bit 2 = X Reserved 

Bit 1 = 1 Alternate gate A20 active 

Bit O = 1 Alternate hot reset 


System board setup enable register, where: 


Bit 7 = 0 Enable system board setup 
1 Disable system board setup 
Bit 6 1 Reserved 
Bit 5 0 Enable VGA setup 
1 Disable VGA setup 
Bits 4-0 = 1 Reserved 


POS channel position select register, where: 


Bit 7 = 1 Channel 1 reset 
Bits 6-4 = Reserved (written as 0, read as 1) 
Bit 3 = 1 Channel select 


Bits 2-0 = 0 Channel number | 
Programmable Interrupt Controller 2 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
Status 


R/W 


I/O Address 


O0Ath 


7 
iW 
om 
mm 
W 
WwW 
W 
W 


z 
z 
z 


00D0h 
00D4h 


R/W 


68 


Description 


Programmable Interrupt Controller 2 mask, 
where: 


Bit 7 = 0 Reserved 

Bit 6 = 0 Enable fixed disk interrupt 

Bit 5 = 0 Enable 80387 exception interrupt 
Bit 4 = 0 Enable mouse interrupt 

Bit 3 = 0 Reserved 

Bit 2 = 0 Reserved 

Bit 1 = 0 Enable redirect cascade 

Bit 0 = 0 Enable real time clock interrupt 


DMA channel 4, memory address register 
DMA channel 4, transfer count register 


DMA channel 4-7, status register, where: 


Bit 7 = 1 Channel 7 request 
Bk 6 = 1 Channel 6 request 
t 


DMA channel 5, memory address register 


Bit 0 = 1 Terminal count on channel 4 


DMA channel 4-7, mask register, where: 
Bits 7-3 = 0 Reserved 


Bit 2 = 0 Clear mask bit 
= 1 Set mask bit 
Bits 1-0 b Select channel 4 


1 Channel 5 request 
1 Channel 4 request 
1 Terminal count on channel 7 
1 Terminal count on channel 6 
1 Terminal count on channel 5 


b Select channel 6 


0 
0 
1 
11b Select channel 7 


0 
4 b Select channel 5 
1 
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Hardware I/O Port List, Continued 


Table: Hardware 1|/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


0O0D6h DMA channel 4-7, Mode Register, where: 


Bits 7-6 = 00b Demand mode 
01b Single mode 
00D8h 
OODAh 


10b Block mode 
11b Cascade mode 


Bit 5 0 Reserved 

Bit 4 0 Reserved 

Bits 3-2 = 00b Verify operation 
01b Write operation 
10b Read operation 
11b Reserved 

Bits 1-0 = 00b Select channel 4 


01b Select channel 5 
10b Select channel 6 
11b Select channel 7 


DMA Clear Byte Pointer 
DMA Master Clear 
DMA Channel 4-7, Clear Mask Register 


DMA Channel 4-7, Write Mask Register, where: 


Bits 7-4 = 0 Reserved 
Bit 3 = 0 Unmask channel 7 mask bit 
= 1 Set channel 7 mask bit 


Bit 2 = 0 Unmask channel 6 mask bit 
= 1 Set channel 6 mask bit 

Bit 1 = 0 Unmask channel 5 mask bit 
= 1 Set channel 5 mask bit 

Bit 0 = 0 Unmask channel 4 mask bit 


1 Set channel 4 mask bit 


Math Coprocessor 


POS Adapter Identification (least significant 
byte) 
POS Adapter Identification (most significant 
byte) 
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Hardware I/O Port List, Continued 


Table: Hardware 1/O Port Definitions, cont’d 


Read/Write af 
1/O Address Status Description — 


R/W POS register 2 for the system board setup, 
where: 
Bit 7 = 0 Enable parallel port extended 
mode 
= 1 Disable parallel port extended 
mode 
Bits 6, 5 = Parallel port select, where: 
= 00 Parallel 1 3BC-3BE 
01 Parallel 2 278-37A 
10 Parallel 3 278-27A 
11 Reserved 
Bit 4 1 Enable parallel port, if bit 0 = 1 
| 0 Disable parallel port 
Bit 3 1 System board serial is serial 1 
. 0 System board serial is serial 2 
Bit 2 1 Enable serial port, if bit 1 = 1 
0 Disable serial port 
| Bit 1 1 Enable diskette, if bit O = 1 
0 Disable diskette 
Bit 0 1 Allows bits 4, 2, and 1 to 
enable/disable devices 
; = 0 Disables system board devices 
For an adapter card, the following bit is 
defined: 
Bit 0 = 1 Enable adapter card 


POS register 3, where: 


Bits 7-2 = Reserved 
Bit 1 = 0 Password disable 
Bit 0 = Reserved 


POS register 4 


POS register 5 for an adapter card, where: 


Bit 7 = 0 Channel check condition occurred 
= 1 Channel reset 
Bit 6 0 Channel check exception status 
available 


POS subaddress extension (least significant 
byte) 
POS subaddress extension (most significant 
byte) 


Fixed disk 
Parallel 3, Data Port 


continued 


0107h 


1FO-1F8h 
200-20Fh 


0278h 
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Hardware I/O Port List, Continued 


Table: Hardware |/O Port Definitions, cont'd 


Read/Write 
1/O Address Status Description 


0279h R/W Parallel 3, Status Port, where: 
Bit 7 = 0 Busy 
Bit 6 = 0 Acknowledge 
Bit 5 = 1 Out of paper 
Bit 4 = 1 Printer is selected 
Bit 3 = 0 Error 
Bit 2 = 0 IRQ has occurred 
Bits 1-0 = Reserved 

027Ah Parallel 3, Control! Port, where: 


Bits 7-6 = Reserved 
- 
- — 


| oe F8h 


Bit 5 = 0 Direction is write to port 
= 1 Direction is read from port 
Bit 4 = 1 Enable IRQ 
Bit 3 = 1 Select printer 
Bit 2 = 0 Initialize printer 
Bit 1 7 Automatic line feed 


Bit O Strobe 


Serial 2, transmitter holding register, where: 


Bits 7-0 Data bits 7-0, respectively, when 
Divisor Latch Access Bit = 0 


Serial 2, receiver buffer register, where: 
Bits 7-0 = Data bits 7-0, respectively, when 
DLAB 


Serial 2, divisor latch, low byte, where: 
Bits 7-0 = Bits 7-0 of divisor, when DLAB = 1 


ees Serial 2, divisor latch, high byte 
Bits 7-0 = Bits 15-8 of divisor, when DLAB = 1 


02F9h Serial 2, interrupt enable register, where: 
Bits 7-4 = 0 Reserved 
: “ 
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Bit 3 = 1 Modem status Interrupt enable 

Bit 2 = 1 Receiver line status interrupt 
enable 

Bit 1 = 1 Transmitter holding register 
empty interrupt enable 

Bit O = 1 Received data available interrupt 


enable when DLAB = 0 


Serial 2, interrupt identification register, where: 


Bits 7-3 = 0 Reserved 
Bits 2-1 =00b Modem status interrupt 
=01b Transmitter holding register 
empty Interrupt 
= 10b Received data available register 
interrupt 
=11b Receiver line status interrupt 
Bit 0 = 0 Interrupt pending 
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Hardware I/O Port List, Continued | 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write | 
1/O Address Status Description 


Serial 2, FIFO control register, where: 


Bits 7-6 = Receiver FIFO register trigger 
00b = 1 byte 
O1ib = 4 bytes 
10b = 8 bytes 
11b = 14 bytes 
Bits 5-3 = 0 Reserved 
Bit 2 = Transmitter FIFO register reset 
1 =transmit FIFO register cleared, 
counter cleared, bit is self- 
clearing 
Bit 1 = Receiver FIFO register reset 
1 =receiver FIFO register cleared, 
counter cleared, bit is self- 
clearing 
Bit 0 = FIFO enable 
1 =receiver and transmitter FIFOs 
enabled, must be 1 to program 
FIFO registers 
0 =clears receive and transmit 
FIFO registers, enters charac- 
ter mode 


Serial 2, line control register, where: 


Bit 7 = 1 Divisor latch access 
= 0 Receiver buffer, transmitter 
holding, or interrupt enable 
registers access 
Bit 6 = 1 Set break enable 
Bit 5 = Stick parity 
Bit 4 = Even parity select 
Bit 3 = Parity enable 
Bit 2 = Number of stop bits 
Bits 1-0 = 00b Word length is 5 bits 
01b Word length is 6 bits 
10b Word length is 7 bits 
11b Word length is 8 bits 


Serial 2, modem control register, where: 


Bits 7-5 = 0 Reserved 

Bit 4 1 Loopback mode 

Bit 3 1 Enable OUT2 interrupt 

Bit 2 1 Force OUT1 active 

Bit 1 1 Force request-to-send active 

Bit 0 1 Force data-terminal—-ready 
active 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


Serial 2, line status register, where: 


Bit 7 
Bit 6 


Bit 5 


Bit 4 
Bit 3 
Bit 2 
Bit 1 


= 0 Reserved 

= 1 Transmitter shift and holding 
registers empty 

Transmitter holding register 
empty 

Break interrupt 

Framing error 

Parity error 

Overrun error 

Data ready 


I 
—_ 


ou nom 
ok et ek 


Serial 2, modem status register, where: 


Bit 7 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


= 1 Data carrier detect 

1 Ring indicator 

1 Data set ready 

1 Clear to send 

1 Delta to carrier detect 

1 Trailing edge ring indicator 
1 Delta data set ready 
1 Delta clear to send 


Serial 2, scratch register 
Fixed Disk Adapter Register (8 or 16 bit) 


Fixed Disk Adapter Control Register, where: 


Bit 7 
Bit 6 
Bit 5 


Bit 4-3 


Bit 2 
Bit 1 


Bit 0 


= 1 Reset 

= 1 Reserved (except during reset) 

1 16-bit mode (must match bit 2) 

0 8-bit mode 

0 Reserved 

1 16-bit mode (must match bit 5) 

0 8-bit mode 

1 Enable interrupt through Program- 
mable Interrupt Controller (hard- 
ware Interrupt) 

= 0 enable interrupt through Interrupt 

Status Register (port 324h) 
= 1 DMA mode 
= 0 PIO mode 


Fixed Disk Adapter Status Register, where: 
Bit 7-6 = 0 Reserved 


Bit 5 


Bit 4 
Bit 3 


Bit 2 


Bit 1 
Bit 0 


Hardware Environment 


= 1 16-bit mode 

0 8-bit mode 

1 Data transfer requested by adapter 
1 Direction is adapter to system 

0 Direction is system to adapter 

1 Busy 

1 Interrupt request (notification) 

1 Transfer in progress 
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Hardware I/O Port List, Continued 


Table: Hardware 1|/O Port Definitions, cont’d 


Read/Write 
I/O Address Status Description 


W Fixed Disk Adapter Attention Register, where: 


Bit 7 = 1 Command control block 
Bit 6 1 Command specify block 
Bit 5 1 Sense summary block 

1 Data transfer requested by system 
0 Reserved 

_ Drive 0 select 

0 


drive 1 select 
Reserved 
1 Abort current command 


Bit 7 = 1 Termination error, bits 0-6 indi- 
cate what the error is | 

1 Invalid command 

1 Command reject 

0 Reserved 

0 Drive 0 selected 

1 Drive 1 selected 

1 Error recovery procedure invoked 
1 Equipment check 


Parallel 2, status port, where: 


Bit 7 = 0 Busy 
Bit 6 = 0 Acknowledge 


Bit 5 = 1 Out of paper 

Bit 4 = 1 Printer is selected 
Bit 3 = 0 Error 

Bit 2 = 0 IRQ has occurred 


Bits 1, 0 = Reserved 


Parallel 2, control port, where: 


Bit 7-6 Reserved 

Bit 5 0 Direction is write to port 

1 Direction is read from port 
1 Enable IRQ 

1 Select printer 

; Initialize printer 
1 


Automatic line feed 
Strobe 


VGA CRT controller index register (mono) 
Other VGA CRT controller registers (mono) 


VGA input status register 1 (mono) 
VGA feature control register (mono) 
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Hardware 1/O Port List, Continued 


Table: Hardware 1|/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


03BCh Parallel 1, data port 
IW 


Parallel 1, status port, where: 
Bit 7 = Q Busy 


Bits 1, 0 = Reserved 


Parallel 1, control port, where: 
Bit 6 = Reserved 


Bit 5 = 0 Direction is write to port 
= 1 Direction is read from port 
Bit 4 = 1 Enable IRQ 
Bit 3 = 1 Select printer 
Bit 2 = 0 Initialize printer 
Bit 1 = 1 Automatic line feed 
Bit 0 = 1 Strobe 


03COh R/W VGA attribute address register 


| oscon 

| 03coh 

| 03th 
| oscen 
Toscan 
Toscan [aw 
| o3sc4h | RW ‘VGA sequencer address register 
| oscsh | R/W__|_ Other VGA sequencer registers 
| oscéh 

| osc7h 

| 0sc7h 

| oscah 

| 0sceh_ 

| scan 

| oscch 


° 

G 

Q) 

nm 

= 
hit 


W 
/ 


° 
@ 
Q 
ie) 
> 


Video DAC PEL mask 
Video DAC PEL address, read mode 


VGA feature control register 


R 
R 
Video DAC state register 
R ' 
. : 
VGA miscellaneous output register 
R 


/W 

| Video DAC PEL address, write mode 
Video DAC PEL data register 

R/W | 


VGA graphics registers, address register 
VGA and other graphics registers 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’d 


76 


O03F 1h 


O3FOh 


Bit 7 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit O 


Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


O3F5h 


Bit 7 
Bit 6 


Bit 0 


Read/Write | 
1/O Address Status Description 


Diskette controller status register A, where: 


Diskette controller status register B, where: 
Bit 7-6 = 0 Reserved 


Diskette controller digital output register, where: 
Bit 7-6 = 0 Reserved 


Diskette controller status register, where: 


-2= 


Diskette controller data registers 


= 1 Interrupt pending 

= 0 Second drive installed 
1 Step 

1 Track 0 

1 Head 1 select 
0 Index 

0 Write protect 
0 Data received by controller 


= Drive select 

= Write data 

= Read data 

= Write enable 

= 1 Motor enable 1 
= 1 Motor enable 0 


= 1 Motor enable 1 

1 Motor enable 0 

0 Allow interrupts 
0 Controller reset 
0 Reserved 

0 Drive select 0 

1 Drive select 1 


| ee 


= 1 Data register is ready 

= 1 Transfer is from controller to 
system | 

= 0 Transfer is from system to 

controller 

1 Non-DMA mode 

1 Diskette controller busy 

Reserved | 

1 Drive 1 busy 

0 Drive 0 busy 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


Diskette controller digital input register where: 


Bit 7 = Diskette change 
Bits 6-1 = Reserved 
Bit O = 0 High density select 


Diskette controller configuration control 
register, where: 


Bits 7-2 = Reserved 
Bits 1-0 = 00b 500 kbs mode 
= 01b Reserved 
= 10b 250 kbs mode 
= 11b Reserved 


Serial 1, transmitter holding register, where: 
Bits 7-0 = Data bits 7-0, respectively, 
when Divisor Latch Access Bit 

(DLAB) = 0 
Serial 1, receiver buffer register, where: 
Bits 7-0 = Data bits 7-0, respectively, 
when DLAB = 0 

Serial 1, divisor latch, low byte, where: 
Bits 7-0 = Bits 7-0 of divisor, when DLAB = 1 


Serial 1, divisor latch, high byte, where: 
Bits 7-0 = Bits 15-8 of divisor, when 

DLAB = 1 
Serial 1, interrupt enable register, where: 
Bits 7-4 = 0 Reserved 


Bit 3 = 1 Modem status interrupt enable 

Bit 2 = 1 Receiver line status interrupt 
enable 

Bit 1 = 1 Transmitter holding register 
empty interrupt enable 

Bit 0 = 1 Received data available interrupt 


enable when DLAB = 0 


Serial 1 Interrupt ID Register, where: 


Bits 7-3 = 0 Reserved 
Bits 2-1 =00b Modem status interrupt 
O1ib Transmitter holding register 
empty interrupt 
10b Received data available 
register interrupt 
11b Receiver line status interrupt 


Bit 0 = 0 Interrupt pending 


Hardware Environment 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


O3FAh W Serial 1, FIFO Control Register, where: 
Bits 7-6 = Receiver FIFO register trigger 
00b = 1 byte 
O1b = 4 bytes 
10b = 8 bytes 
11b = 14 bytes 
Bits 5-3 = 0 Reserved 
Bit 2 = Transmitter FIFO register reset 
1 = transmit FIFO register cleared, 
counter cleared, bit is self- 
clearing 
Bit 1 = Receiver FIFO register reset 
1 = receiver FIFO register cleared, 
counter cleared, bit is self- 
, clearing 
Bit 0 = FIFO enable 
1 =receiver and transmitter FIFOs 
enabled, must be 1 to program 
| FIFO registers 
0 = clears receive and transmit 
FIFO registers, enters 
| character mode oad 
O3FBh Serial 1, Line Control Register, where: 


Bit 7 = 0 Receiver Buffer, Transmitter 
- 


Holding, or Interrupt Enable 
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Registers Access 


= 1 Divisor Latch Access 
Bit 6 = 1 Set Break Enabled 
Bit 5 = Stick Parity 
Bit 4 = Even Parity Select 
Bit 3 = Parity Enable 
Bit 2 = 01 Stop Bit 

= 10 Stop Bits — 
Bits 1-0 = 00b 5 Bit Word Length 


O1b 6 Bit Word Length 
10b 7 Bit Word Length 
11b 8 Bit Word Length 
Serial 1, Modem Control Register, where: 
Bits 7-5 = 0 Reserved 


Bit 4 = 1 Loopback mode 

Bit 3 = 1 Enable OUT2 interrupt 

Bit 2 = 1 Force OUT1 active 

Bit 1 = 1 Force request to send active 

Bit 0 = 1 Force data terminal ready active 
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Hardware 1/O Port List, Continued 


Table: Hardware 1!/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


O3FDh R/W Serial 1, Line Status Register, where: 
Bit 7 = 0 Reserved 
Bit 6 = 1 Transmitter shift and holding regis— 
ters empty 

Bit 1 Transmitter holding register empty 
1 Break interrupt 
1 Framing error 
1 Trailing edge ring indicator 
1 Overrun error 
1 Data ready 


O3FEh Serial 1 Modem Status Register, where: 
Bit 7 = 1 Data carrier detect 
Bit 6 = 1 Ring indicator 
Bit 5 = 1 Data set ready 
Bit 4 = 1 Clear to send 
Bit 3 = 1 Delta data carrier detect 
Bit 2 = 1 Trailing edge ring indicator 
Bit 1 = 1 Delta data set ready 
Bit O = 1 Delta clear to send 


| O3FFh | oR Serial 1, Scratch register 
0680h Manufacturing checkpoint port 


3220-3227h See Serial Port 3 (see description for addresses 
O3F8h-O3FFh O3F8h-O03FFh for details). 
3228-322Fh See Serial Port 4 (see description for addresses 
O3F8h-O3FFh O3F8h-O3FFh for details). 
4220-4227h See Serial Port 5 (see description for addresses 
O3F8h-O3FFh O3F8h-O3FFh for details). 
4228-422Fh See Serial Port 6 (see description for addresses 
O3F8h-O3FFh O3F8h-O3FFh for details). 
See 
ee 


9220-5228h Serial Port 7 (see description for addresses 
O3F8h-O03FFh O3F8h-O3FFh for details) 

5228-522Fh S Serial Port 8 (see description for addresses 
O3F8h-O03FFh O3F8h-O03FFh for details) 
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Chapter 3 
ABIOS Data Structures 


Overview 


Description 


ABIOS makes use of data structures to link ABIOS services/functions to the 
operating system. The data structures reside in system memory and are 
initialized during ABIOS initialization. The ABIOS data structures are the 

= Common Data Area, 

» Function Transfer Tables, and 

» Device Blocks. 


continued 
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Overview, Continued 


Data structure relationships 


Each ABIOS service has a Function Transfer Table and a Device Block asso- 
ciated with it. 


1. The Function Transfer Table contains address pointers to each ABIOS | 
function. 


2. The Device Block is used by the ABIOS to store interrupt levels, device 
status information, and hardware port addresses. 


3. The Common Data Area contains a linked list of the Function Transfer 
Table and Device Block pointer pairs associated with each service, as well 
as device memory pointers (if any) associated with a given device. 


Data Structure Relationships 


Common ABIOS Service 
Data Area 


@) 


Logical ID | 
® 
Device | 
Block Pointers Device Status | 


Function 
Transfer Table 


Device Block 


Pointers : Function 
Transfer Table 


ft eae 
Pointers Functions 


Hardware Device 
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Overview, Continued 


In this chapter 


This chapter defines the internal components of each kind of ABIOS data 
structure. The following topics are discussed: 


» Common Data Area 

=» Function Transfer Tables 
» Device Blocks 

» Related Information 
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Common Data Area 


Introduction 


Created during ABIOS initialization, the Common Data Area (CDA) is pro- 
vided so that operating systems that use both the real and protected ad- 
dress modes (or a combination of both) of the system microprocessor can 
be implemented. The main features of the Common Data Area are outlined 
below: 


Common Data Area 


Number: One per processor mode 
(See Chapter 4. ) 


Logical | Device Block 

ID Pointer Kind: Vector table 
Function 

Transfer Table Access: ABIOS & Operating System 


Description: 


Logical | Device Block 
ID Pointer The Common Data Area contains pointers to the 


Device Block and Function Transfer Table associ- 
pee Tabi ated with each ABIOS service. It also contains 
Pasi et -Levle pointers to the device memory (if any) accessed 
by any ABlOS-supported device. 
Device Block 
Pointer The pointers contained in the Common Data Area 
Function are divided into two arrays: 


Transfer Table » The first array contains pairs of pointers to the 

Device Blocks and Function Transfer Tables. 

Data Pointer 0 Each pair of entries is indexed by Logical ID. 
Length, Offset, Segment The second array contains pointers to the de- 
vice memory (if any) accessed by any ABIOS- 


Data Pointer 1 supported device. 


Length, Offset, Segment 


Data Pointer xxh 


Length, Offset, Segment 


Real mode/protected mode CDAs 


The Common Data Area acts as a link between all ABIOS pointers. It gathers 
them all in one structure, allowing an operating system to manage the ABIOS 
requests in both real and protected modes. There must be a Common Data 
Area in both the real mode and the protected mode if both address modes 
are used by the operating system. 


continued 


84 ABIOS for IBM PS/2 Computers and Compatibles 


Common Data Area, Continued 


The Anchor Pointer 


Every time the operating system makes a request of the ABIOS, it passes a 
segment or selector (the offset is assumed to be zero) to the ABIOS. This 
selector points to the Common Data Area and is called the Anchor Pointer to 
the Common Data Area. 


Device IDs and Logical IDs 


Device IDs are physical device identifiers that are attached to each device 
known to the ABIOS. Each Device ID may have one or more Logical IDs. A 
Logical ID is a device handle used by the operating system to make a call to 
the ABIOS. Logical IDs are assigned during ABIOS initialization. 


Device Data pointers 


The Common Data Area data pointers point to system data areas such as 
the CBIOS Data Area. Additional data pointers may be defined and used by 
individual services. The data areas pointed to by the data pointers are per- 
manently resident in RAM data areas reserved by the operating system. 


Null entries into the Common Data Area 


If the Function Transfer Table Pointer and the Device Block Pointer Fields are 
both set to 0000:0000h after initialization, the associated Logical ID must be 
thought of as a null Common Data Area entry. The entire entry for this 
Logical ID is used as a temporary place holder at initialization time. 


continued 
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Common Data Area, Continued 


Common Data Area structure 


OFFSET TO DATA POINTER 0 
Combined with the Anchor Pointer, is a pointer to the 
Data Pointer 0 Length field. | . 


COUNT OF LOGICAL IDS 
0Ch 
14h 


Number of Device Block and Function Transfer Table 


pointer pairs 
Reserved 


a Sa Pointer to Device Block for Logical ID 2. 
|g Pointer to Function Transfer Table for Logical ID 1. 
oa Pointer to the Device Block for Logical ID 2. 


Pointer to the Function Transfer Table for Logical ID 2. 
Pointer to the Device Block for Logical ID n. 


Pointer to the Function Transfer Table for Logical ID n. 


(O8h*n) + 08h LENGTH OF THE INDICATED DATA POINTER 
Data pointer length of the data areas indicated by an 
associated data pointer. 

(O8h*n) + OAh OFFSET OF THE INDICATED DATA AREA 
Combined with associated data pointer segment, indi- 
cates the location of the beginning of the data area. 

| (08h*n) + OCh DATA AREA POINTER SEGMENT 
Combined with its associated offset, indicates the lo- 


cation of the beginning of the data area. 
(O8h*n) + OEh Length of the data pointer for pointer p - 1. 
(O8h*n) + 10h 


DATA AREA OFFSETS 
(O8h*n) + 12h 


(O8h*n) + 04h 


Combined with an associated segment to construct the 
pointer to the data area for pointer p — 1. 


DATA AREA SEGMENTS 
Combined with an associated data area offset to con- 
struct the pointer to the data area for pointer p - 1. 


(O8h*n) + | Length of data pointer 0. 
(O6h*p) + 08h 


(O8h*n) + DATA AREA OFFSET ; 
(O6h*p) + OAh Combined with an associated segment to construct th 
| pointer to the data area. | 


DATA AREA SEGMENTS 
Combined with an associated data area offset to con- 
struct the pointer to the data area. 


(O8h*n) + 
(O6h*p) + OCh 


(O8h*n) + 


The total number of data pointers. 
(O6h*p) + OEh 


Note: nis the number of Logical IDs. p is the number of Data Pointers minus one. 
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Function Transfer Table 


Description 


The Function Transfer Table is a table of vectors to ABIOS entry points. 
Each entry contains the four-byte address pointer for each ABIOS function. 
Reserved function pointers are initialized to 0000:0000h. 


Each logical ID, or each entry in the Common Data Area, has a Function 
Transfer Table Pointer. Multiple Logical IDs can have Function Transfer Table 
Pointers that point to the same Function Transfer Table and thus establish its 
relationship with the Common Data Area. 


The main features of the Function Transfer Table are outlined below: 


| Function Transfer Table 


Start Routine 
Interrupt Routine 
Time-out Routine 


Vector —> 
Vector —»> 
Vector —> 


Count of functions in service 


Function 00h 
Function Oth 
Function 02h 
Function 03h 
Function 04h 
Function 05h 
Function 06h 
Function 07h 
Function 08h 
Function 09h 
Function nnh 


Vector 

Vector —p» 
Vector _» 
Vector _» 
Vector —» 
Vector —p» 
Vector —» 
Vector _» 
Vector —p» 
Vector —p» 
Vector —» 


Number: One per ABIOS service and one per 
processor mode used (See Chapter 4 
in this volume. ) 


Kind: Double Word Vector table 
Access: ABIOS and operating system 


Description: 


The Function Transfer Table contains a list of 
double word vectors that supply the entry points 
into one ABIOS service. 


The first three entries in each ABIOS Function 
Transfer Table are vectors to the start, interrupt, 
and time-out routines contained in an ABIOS 
service. 


The remaining entries in each Function Transfer 
Table are vectors to specific ABIOS functions. 
These functions are referred to by function number 
in the Request Block Function field. 


The start and interrupt routines check for valid 
entry conditions before transferring control to the 
function requested. The time-out routine ends a 
function that does not receive an interrupt in a 
specified amount of time. 
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Function Transfer Table, Continued 


Function Transfer Table structure 


The structure of the Function Transfer Table is described in the 
following table: 


ae START ROUTINE POINTER 


Pointer to a routine that validates the Function field, Re- 
quest Block Length field, and the Unit field. The routine 
saves all registers before this field is used and restores 
oy 
Contains a count of the number of functions supported by 
a device. 


them after it returns. The routine is called using a CALL 
[orn | 2 [Peed SS 
a 


if the operation is not completed in one request. The rou- 
tine saves all registers before this field is used and re- 
stores them after it returns. If this Function Transfer Table 
corresponds to a device that does not interrupt, the Inter- 
rupt Routine Pointer Field is initialized to 0000:0000h. This 
routine is called using a CALL FAR indirect to resume a 
multistaged request after an interrupt is cleared. 


TIME-OUT ROUTINE POINTER 
Pointer to a routine that aborts the request, and, as a 
result, sets the affected hardware controller in a known 
state. The routine saves all registers before this routine 
executes and restores them after it returns. The Time-out 
Routine is called using a CALL FAR indirect. It is used to 
terminate a request that does not receive a hardware in- 
terrupt within a specified time period. If this Function 
Transfer Table corresponds to a device that does not gen- 
erate interrupts, or a device that generates interrupts but 
never times out, the Time-out Routine Pointer field must 
be initialized by the operating system to 0000:0000h. 


FUNCTION COUNT 


FAR indirect to start an ABIOS request. 
INTERRUPT ROUTINE POINTER 
Pointer to a routine that resumes all multistaged requests 

OCh 
10h Pointer to the Function 1 Routine. 

Pointer to the Function 2 Routine. 

OCh + (4*n) Pointer to the Function n Routine. 
Note: i] ‘a iia to the number of functions specified in this Function Transfer 
able. 
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Device Block 


Description 


Each ABIOS device service requires a permanent work area for storing 
device interrupt levels, device status information, and hardware port ad- 
dresses. This work area is called the Device Block. 


The main features of the Device Block are summarized in the graphic below: 


Device Block 


Public Data 


Device Block Length 
Revision 

Secondary Device ID 
Logical ID 

Device ID 

I/O Port Pairs 


Private Data 


Device Unique Data 
Unit Unique Data 


Public data 


Number: One per ABIOS service 
Kind: Work area 


Access: Public data — ABIOS and operating system 
Private data — ABIOS only 


Description: 


Physical devices are linked to the ABIOS services by 
Device ID. The ABIOS services, in turn, are linked to the 
operating system by Logical ID. Logical IDs are assigned 
dynamically by the operating system during ABIOS 
initialization. 


The Device Block associated with any ABIOS Service 
contains public information such as the Device Block 
length, the Logical ID/Device ID pairing, and the I/O port 
pairs used by the associated ABIOS service. Public 
information is accessible by both the operating system 
and the ABIOS itself. 


The Device Block also contains data that is private to the 
individual ABIOS Service and is subject to change in 
future ABIOS releases. Typically, Device Block private 
data includes the interrupt level, arbitration level, and 
device status. Private information must only be accessed 
by the ABIOS. 


Public Data in the Device Block 


» is readable, 


=» has a format common to all Device Blocks, and 
» should not be changed by the caller. 
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Device Block, Continued 


Private data 
Private data in the Device Block 
= is used internally by the ABIOS, 
= may not have the same format from one Device Block to another, 


= may not contain the same kind of data from one Device Block to the 
next, and 


=» should not read or be written to by the caller. 


Private data in the Device Block may be altered in future ABIOS releases. 


Device Block structure 


The structure of the Device Block is described in the following table. 


Offset Description | 


00h | DEVICE BLOCK LENGTH 
ABIOS returns the required size of the Device 
Block here during ABIOS initialization. The maxi- 
mum length is 65,535 bytes. 


REVISION 
Indicates the ABIOS version/revision level. 


SECONDARY DEVICE ID 

Indicates the hardware level that ABIOS supports. 
When this field is incremented, the Revision Field 
reverts to zero. 


LOGICAL ID 
The logical identifier of the davies associated with 
this Device Block. Logical IDs are set at ABIOS 
initialization time. The Logical ID for a given device 
is determined by the index of its entry into the 
Common Data Area. 


The operating system must reserve the first n 
Logical IDs for ABIOS use. The number of Logical 
IDs to be reserved for ABIOS use is passed to the 
operating system at ABIOS initialization time via 
the Initialization Table. 


(A table describing how the ABIOS Logical IDs are 
used follows this table.) 


DEVICE ID 
The type of device that the function request ad- 
dresses, or the ABIOS internal call, is specified in 
ae o (A table of valid ABIOS Device IDs fol- 
Ows. 


continued 
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Device Block, Continued 


Device Block structure, cont’d 


COUNT OF LOGICAL ID 
EXCLUSIVE PORT PAIRS 
. - 


Logical ID exclusive port pairs are two ports (input 
Varies Private 7 


and output) used by a certain Logical ID. For ex- 


ample, !/O ports 0061h and 0062h are used by the 
diskette services Logical ID. 


If the entry in this field is zero, no space is 
allocated for the Logical ID Exclusive Port Pairs 
Fields. This field contains the number of Logical ID 
Exclusive Port Pairs. 


COUNT OF LOGICAL ID 
COMMON PORT PAIRS 
Logical ID common port pairs are ports that are 
shared by more than one Logical ID. For example, 
the DMA controller ports or Keyboard Controller 
ports are used by other Logical IDs. Each Logical 
ID that uses one of these ports contains an entry 
in the Logical ID Common Port pairs fields of the 
Device Block. If this field is set to zero, no space 
is allocated for the Logical ID Common Port Pairs 
Field. This field contains the number of Logical ID 
Common Port Pairs for this Request Block. 


LOGICAL ID EXCLUSIVE PORT PAIRS 
Contains the Logical ID Exclusive Port Pairs for 
this Request Block. The first word contains the 
starting 1/O port number; the last word contains 
the ending I/O port number. 


Note: Every port that an ABIOS Logical ID writes 
to or reads from must be accounted for in 
either the Logical ID Exclusive Port Pairs or 

Logical 1D Common Port Pairs Fields. 


LOGICAL ID COMMON PORT PAIRS 
Points to a list of the I/O Port addresses of the 
Logical |D Common Port Pairs. The first word 
contains the starting I/O port number; the last 
word contains the ending I/O port number. 


Note: Every port that an ABIOS Logical ID writes 
to or reads from must be accounted for in 
either the Logical 1D Exclusive Port Pairs or 

Logical ID Common Port Pairs Fields. 


DEVICE-UNIQUE DATA AREA LENGTH 
Contains the length in bytes of the Device-Unique 
Data Area for this device. 


continued 
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Device Block, Continued 


Device Block structure, cont'd 


= E as 


Information about arbitration levels, interrupt lev- 
els, and device status is stored in this field. Pa- 

=P 

fae 


rameters that describe the device and working 


data that concerns this Device ID are stored in 

this field. The information in this field is data that 

is unique to this particular device. The content and 
format of the information in this field are Private 
Data and may change. 

Note: n is the last Logical ID reserved for ABIOS internal calls. This value 
will vary depending on how many Logical IDs ABIOS must reserve for 
internal use, extending, and adding functions. ABIOS passes this value 

to the operating system at ABIOS initialization by noting it in the 

initialization table. 


COUNT OF UNITS 
The number of Unit Unique Data Area fields in the 
Device Block is stored in this field. If the entry is 
zero, this field is the last field in the Device Block. 


UNIT-UNIQUE DATA AREA LENGTH 
The length in bytes of a single entry in the repeat- 
able Unit-Unique Data Area, not including the 
Unit-Unique Data Area Length, is stored here. 
This field will be here only if the Count of Units 
field is greater than zero. 


UNIT-UNIQUE DATA AREA 
This repeatable ABIOS Private Data area is re- 
served for each unit of the Device ID. For exam- 

| ple, if the diskette Logical ID is 01h, a particular 
diskette drive will be the Unit. This area contains 

| Parameters describing the unit and the working 
data for individual requests. The contents and for- 
mat of the data in this field may change, since it 
is ABIOS Private Data. This field will be here only 
if the Count of Units Field Is greater than zero. 


continued 
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Device Block, Continued 


Table of Logical ID Values 


| Oh Reserved for use by ABIOS. 
p Oth Reserved for use by ABIOS. 


O2h-xxh Reserved for use by ABIOS. xxh Is specified by the operat- 


ing system in the Initialization Table when the ABIOS is in- 
greater than xxh 


Itialized. xxh is the number of ABIOS logical IDs. 


System board ROM, adapter ROM, RAM extension. 


Device IDs 
The following table lists all valid ABIOS Device IDs. 


Device ID | Device Type/Service Device ID | Device Type/Service 


| 00h | ABIOS Internal Calls | _——OBh__—| Pointing Device 
[on] Diskette ——=S*dCSCh | Reserved 
[oan] Fed Disk +4 oDnh | Reserved 
[oan | Keyboard | oFh | Direct Memory Access 
Tosh | Parallel Port] 10h | Programmable Option Select 
[—o6n | Serial Port [11h Errortog 
[07h | System Timer | 1an-16h | Reserved 
[—o8nh | Real Time Clock Timer | _1eh___| Keyboard Security 
[ooh | system Services| i7n-FFFFn | Reserved 
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Related Information 


Data structure initialization 


The discussion of ABIOS data structures presented in this chapter is confined 
to a detailed presentation of data structure internal components. No mention 
was made, however, of how these structures are initialized. 


For more information on how ABIOS Data Structures are initialized, refer to 
Chapter 4. | | 


Request Blocks 


In addition to the ABIOS data structures, the ABIOS also interfaces with 
RAM-resident parameter blocks called Request Blocks. 


The ABIOS caller must initialize one Request Block per function call. The 
input, Output, and status parameters associated with a given function call are 
stored in the Request Block dedicated to that call. Request Blocks associ- 
ated with completed function calls can be reused. 


For a complete discussion of Request Block structure, turn to Chapter 5. 


Transfer conventions 


Each time an ABIOS device function is called, the caller must build a 
function—specific Request Block, push a set of pointers to the ABIOS Data 
Structures onto the stack, and invoke the appropriate function entry routine. 


ABIOS functions can be called via either of two transfer conventions: the 
operating system transfer convention and the ABIOS transfer convention. The 
difference between these two conventions lies in the stack information and 
the entry routine called. 


For more information on how ABIOS functions are called, turn to Chapter 7. 
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Chapter 4 
ABIOS Initialization 


Overview 


Initialization facts 
Before ABIOS can be used, it must be initialized. Here are the key facts 
surrounding ABIOS initialization: 
» Before ABIOS can be initialized, CBIOS must be initialized and the operat- 
ing system must be booted. 
=» ABIOS can only be initialized in the microprocessor’s real mode. 


# Initializing ABIOS is largely a matter of initializing the ABIOS data 
structures. 

=» In bimodal environments, the operating system must initialize parallel sets 
of Common Data Areas and Function Transfer Tables. 


continued 
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Overview, Continued 


Initialization steps 


ABIOS initialization flow is illustrated below. 


Initialization Flow ik 


CBIOS INT 15h 
AH=04h 
Build System 
Parameters Table 


CBIOS INT 15h 
AH=05h 


Build Initialization 
Table 


Build Common 
Data Area 


Build: 
Device Blocks 
Function Transfer 
Tables 


Build Protected 
Mode: 
Common Data 
Area Function 
Transfer Tables 


STEP 1: Build System Parameters Table 


The operating system calls CBIOS INT 15h AH = 04h Build 
System Parameters Table. The CBIOS builds the System 
Parameters Table in system RAM. The table describes 
the system stack requirements, the number of devices 
installed in the system, and the entry points to the rou- 
tines used during the ABIOS Calling Convention. 


STEP 2: Build ABIOS Initialization Table 


The operating system calls CBIOS INT 15h AH = 05h Build 
Initialization Table. The CBIOS builds the Initialization Table 
in system RAM. The table defines the information used to 
initialize the Device Block and Function Transfer Table 
associated with each ABIOS device. 


STEP 3: Build Common Data Area 


The operating system allocates system memory for the 
Common Data Area, Device Blocks, and Function Transfer © 
Tables. The operating system builds the Common Data 
Area, initializes all Device Block and Function Transfer 
Table pointers, and assigns Logical IDs. 


STEP 4: Initialize DBs and FTTs 


The operating system calls the ABIOS to initialize the 
Device Block (DB) and Function Transfer Table (FTT)as- 
sociated with each ABIOS service. The Common Data 
Area, Device Blocks, and Function Transfer Tables reside 
in RAM for as long as ABIOS is active. 


STEP 5: Build Protected Mode Structures 


In bimodal or protected mode environments, the operating 
system must build protected mode versions of the Com- 
mon Data Area and Function Transfer Tables. This proc- 
ess converts real mode segment:offset pointer to pro- 
tected mode selector: offset format. | 


continued 
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Overview, Continued 


About Request Blocks 


Request Blocks, which are initialized by the operating system as each func- 
tion request arises, are not built as part of the ABIOS initialization process. 


For more information on Request Blocks, please refer to Chapter 5. 


In this chapter 


This chapter details each of the steps required to initialize ABIOS. The follow- 
ing topics are discussed: 


Step 1: Build System Parameters Table 

Step 2: Build ABIOS Initialization Table 

Step 3: Build the Common Data Area 

Step 4: Initialize Device Blocks/Function Transfer Tables 
Step 5: Build Protected Mode Tables 

Initializing Logical ID 2: ABIOS Internal Calls 

How ABIOS Supports Multiple Instances of a Device 
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Step 1: Build the System Parameters Table 


introduction 


In step 1 of the ABIOS initialization process, the operating system calls 
the CBIOS INT 15h AH = 04h Build System Parameters Table function. 


The System Parameter table describes the number of devices available 
in the system, the ABIOS common entry points and the. system stack 
requirements. 


Once the ABIOS initialization process is complete, the operating system 
may deallocate the memory space occupied by the System Parameters 
Table. 


System Parameter table 


The structure of the System Parameter Table is listed below: 


Description | 


4 Bytes COMMON START ROUTINE POINTER 
Contains the address of the Common Start Routine entry 
point. 


COMMON INTERRUPT ROUTINE POINTER 
i — 


Contains the number of bytes of stack memory that is re- 
quired for the particular ABIOS implementation. 


Contains the address of the Common Interrupt Routine 
entry point. | 
COMMON TIME-OUT ROUTINE POINTER 
Contains the address of the Common Time-—out Routine 
OCh 
RESERVED | 
RESERVED 


entry point. 
li ry aos at 


STACK REQUIRED 
The ABIOS gathers configuration information by polling the 


Common Data Area and by scanning for the presence of 
ROM and RAM extensions to the ABIOS. 


continued 
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Step 1: Build the System Parameters Table, Continued 


Operating system tasks 
To build the System Parameters table, the Operating System must 
1. Allocate 20h bytes for CBIOS to build the system parameters table. 
2. Call CBIOS INT 15h, function AH = 04h, Build System Parameters Table. 


3. Optionally deallocate the memory used for the System Parameters Table 
after the ABIOS initialization process is complete. 


CBIOS Function: INT 15h AH = 04h Build System Parameters Table 
The CBIOS Build System Parameters Table function: 


1. Establishes the value of the System Parameters Table’s Number of Initiali- 
zation Table Entries field by examining configuration information in CMOS 
RAM, the system equipment data area, and by testing for the presence 
of those devices with operating code that resides in system ROM. 


2. Scans in 2K increments absolute addresses CO000h to DF800h to deter- 
mine the presence of adapter ROM (if any), updating the Number of 
Initialization Table Entries field accordingly. 


3. Scans the RAM extension area pointed to by the parameter passed by the 
operating system in the DS register to count the number of entries (if 
any) to add to the Number of Initialization Table Entries field. 


4. Builds the System Parameter Table in the 20h byte location allocated by 
the operating system. 


Input/Output 


Input: AH = O4h 
ES:Dl= Pointer to 20h byte location in RAM where the table is to 
be built. 
DS = Segment where ABIOS RAM Extensions reside. If there are 
no RAM extensions, this register must be set to O000h. 
(ABIOS RAM extension offset is assumed to be 0000h) 


Output: System Parameter Table is output to RAM 
AH = QOh If function was successful 
CF 1 Exception error has occurred 


All registers except AX and flags are restored. 


ABIOS Initialization | 99 


Step 2: Build ABIOS Initialization Table 


Introduction 


Once the System Parameters Table is built, the operating system must call 
CBIOS INT 15H function AH = 05h to build the ABIOS Initialization Table. 


The information contained in the Initialization Table is referred to later in the 
ABIOS initialization process in two ways: 


« In step 3, the operating system refers to the ABIOS Initialization Table to 
determine the size of the Common Data Area, as well as the size of each 
Device Block and Function Transfer Table. 


» In step 4, the ABIOS refers to the Initialization Table when initializing 
Device Blocks and Function Transfer Tables. 


Initialization Table Structure 


The Initialization Table is made up of fields of 18h bytes. The information in 

each field is repeated for each device found by the CBIOS INT15h AH = O5h 
Build ABIOS Initialization Table function. The entries making up each field are 
described in the following table. | 


| Offset Length Description 


2 Bytes | DEVICE ID 
The same Device ID can appear more than one time within 


the Initialization table. Device IDs are listed in Chapters 1 
| 


and 3. 
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NUMBER OF LOGICAL IDs 


The maximum number of Logical IDs used by the operating 
system is stored in this field. This field stores the maximum 
number of devices that require Device Blocks but are used 

by the same code. 


DEVICE BLOCK LENGTH 


Contains the allocation of storage needed by the Device 
Block for this device. If a Device Block Length is zero, this 
entry is for an ABIOS patch or extension. A zero length 
entry means that a Device Block need not be built for this 
entry. If the Device Block Length is zero, the operating 
system must initialize the Device Block Pointer in the Com- 
mon Data Area to 0000:0000h. See Chapter 7 ABIOS Ex- 
tensions for more detail on modifying the ABIOS. 
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Step 2: Build the Initialization Table, Continued 


Initialization Table Structure, cont’d 


aes EOnGEN Description 


INITIALIZE DEVICE BLOCK AND 
FUNCTION TRANSFER TABLE ROUTINE POINTER 


Contains the address, in real address mode, segment: off- 
set format, of the routine that will initialize the Device 
Blocks and Function Transfer Tables for an entry in the 
Initialization Table. Adapter ROMs and RAM extensions 
must also provide this routine to patch, add, extend, or 
replace services. See Chapter 7 ABIOS Extensions for 
more detail on modifying ABIOS functions. 
REQUEST BLOCK LENGTH 


Contains the length of the Request Block required for this 
device. Any Request Block size equal or greater to this size 
is valid when making a request to the ABIOS. 
FUNCTION TRANSFER TABLE LENGTH 
Contains the Function Transfer Table length, in bytes. 
If the Function Transfer Table length is zero, 

» this entry is for a patch, 


» the data area for the Function Transfer Table need not 
| be allocated, and 


» the operating system must initialize the Function 

Transfer Table Pointer field in the Common Data Area 
to 0000:0000h. 
DATA POINTERS LENGTH 
Contains the required length of the data pointer fields in the 
Common Data Area. 
SECONDARY DEVICE ID 
Indicates the level of hardware that this ABIOS version 
supports. 
REVISION 


Indicates the device driver revision level that ABIOS sup- 
ports for this device. 


- 
: 
. 


[ian [eeyes [resenveoOSOSCS~—~—S 
[ian [2 eytes [reserves 
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Step 2: Build the Initialization Table, Continued 


Operating system tasks 


The operating system must perform the following steps to help build the 
Initialization Table: 


1. Allocate an area of memory where the CBIOS will build the Initialization 
Table. The area must be 18h times the number of entries in the Initializa- 
tion Table. The information about the number of entries in the Initialization 
Table can be found in the System Parameters Table under the Number of 
Entries field. 


2. Call INT 15h, function AH = 05h, Build Initialization Table. 


Memory allocated for the Initialization Table may be reused by the operating 
system after the initialization process is complete. 


CBIOS Function: INT 15h AH = 05h Build Initialization Table 


The CBIOS Build Initialization Table function must: 

1. Use the following order of precedence for Initialization Table entries: 
a. system board devices 
b. adapter ROM devices (CBIOS uses POST for this search) 
c. extension RAM devices. 


2. Construct the Initialization Table using information found in system ROMs, 
adapter ROMs (if any), and the RAM extensions (if any). 


Input/Output 


Input: AH = O5h 
ES:Dl= Pointer to location in RAM where the table is to be built. 
DS = Segment of the Extended System RAM data area. 
(Offset is assumed to be 0000h) 


Output: ABIOS Initialization Table is output to RAM 
AH = OOh If function was successful 
CF = 1 Exception error has occurred 


All registers except AX and flags are restored. 
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Step 3: Build the Common Data Area 


Introduction 


Once the System Parameters Table and ABIOS Initialization Table are built, 
the operating system has all the information it needs to build the Common 
Data Area. 


Operating system tasks 


The Operating System builds the Common Data Area in the following 
sequence: 


1. 


Allocates memory at offset 0 within a segment for the Common Data 
Area. The operating system saves a pointer (called the Anchor Pointer) 
to this segment. 


. Allocates memory within the Common Data Area for pointers to the 


Device Block and Function Transfer Table associated with each ABIOS 
device service. 


Allocates memory for pointers to the data area (if any) associated with 
each ABIOS device service. 


Initializes the offset to the Data Pointer 1 Field so that it points to the 
Data Pointer Length 0 Field in the Common Data Area. 


. Initializes the Data Pointer Count Field to zero. 
. Places the number of Device Block and Function Transfer Table pointer 


pairs in the Count of Logical IDs Field in the Common Data Area. 


. Initializes each Device Block Pointer to point to the memory location that 


has been allocated for that particular Device Block. 


. Initializes each Function Transfer Table Pointer to point to the memory 


location that has been allocated for that particular Function Transfer 
Table. 


. Assigns a Logical ID to each pair of Device Block/Function Transfer Table 


pointers. 
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Step 3: Build the Common Data Area, Continued 


Logical IDs 


A Logical ID identifies the logical name of the device associated with one 
Device Block. 


Logical ID numbering 


During step 3 of the ABIOS initialization process, the operating system as- 
signs Logical ID numbers ordinally, according to the rules defined in the 
table below: 


Logical ID | Description 


Reserved for use by ABIOS. 
) Oth Reserved for use by ABIOS. 


Reserved for ABIOS Internal Calls. 

Logical IDs 2 to nnh are reserved for ABIOS internal calls. xxh Is 
ied number of the last Logical ID reserved for ABIOS internal 
Calls. | 


Logical ID 2 is always defined. All remaining entries in the Initlall- 
zation Table with Device !D 0 must be initialized as reserved for 
ABIOS internal calls. This insures support for patches to the 
ABIOS Common Routines. 


02h-xxh 


greater than xxh{| Reserved for ABIOS Services. 


The starting Logical ID assigned to an ABIOS device must be 
one greater than nnh. System board, adapter devices, RAM 
extension devices are assigned Logical ID numbers in this range. 


Device 00h and Logical ID 02h 


Device OOh is not associated with a particular hardware device but is pro- 
vided to allow for ABIOS internal calls. 


In the ABIOS system ROM, code associated with the ABIOS Common Entry 
Routines is contained in the Device OOh service. The operating system al- 
ways assigns Logical ID 02h to the system ROM Device OOh service. 


For more on Common Entry Routines 


Control can be optionally transferred to any given ABIOS service via the 
Common Entry Routines. A complete discussion is found in Chapter 6. 


continued 
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Step 3: Build the Common Data Area, Continued 


Device 00h and Logical IDs 02h + xxh 


Subsequent instances, if any, of Device 00h correspond to ABIOS extensions 
designed to patch the Common Entry Routines contained in the system ROM 
Device 00h service. The operating system ordinally assigns a Logical ID to 
each subsequent Common Data Area entry with Device OOh. 


Logical ID nnh 


Once it has assigned Logical IDs to Device OOh, the operating system 
assigns a Logical ID, ordinally, to each pair of Device Block/Function Transfer 
Table pointers in the Common Data Area. 


It is possible for a single ABIOS service to be assigned more than one Logi- 
cal ID. The number of Logical IDs assigned to a service lies in the relation- 
ship between the number of hardware devices that will access the service’s 
code, and the interrupt and/or arbitration level associated with each device. 


For more on multiple Logical IDs 


For more information on multiple Logical IDs, see How ABIOS Supports 
Multiple Instances of a Device later in this chapter. 
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Step 4: Initialize Device Blocks and Function Transfer Tables 


Introduction 


Whether it is in system ROM, adapter ROM, or in an ABIOS RAM extension, 
each ABIOS service contains a routine to initialize the Device Block (DB) and 
Function Transfer Table (FTT) associated with that service. Once it has built 
the Common Data Area, the operating system calls each of these routines. 


Operating system tasks 


For each field in the Initialization Table, the operating system must 


1. load the CX, DX, and DS registers with the parameters required for entry 
into the Device Block and Function Transfer Table initialization routine 
associated with the Initialization Table. 


2. invoke the initialization routine contained in the Initialize Device Block and 
Function Transfer Table Routine pointer entry for the field under consid- 


eration. 


3. after the initialization routine completes, convert all 32-bit Data Pointers 
contained in the Common Data Area to segment:offset address format. 


Input/Output 


Here is a definition of the input parameters that must be passed, and the 
output parameter that is returned. 


Input: CS:|IP= 
CX: <= 


Output: AL = 


Pointer to Initialization Routine 

Number of Logical IDs to initialize. This number must be 
less than or equal to the number of Logical IDs allowed 
by the Number of Logical IDs field in the Initialization 
Table. 

Starting Logical ID 

Anchor Pointer to Common Data Area 

(Segment value: Offset is assumed to be 0000h) 


OOh Success 
Oth Device initialization failure. 


All other registers are preserved. 
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Step 4: Initialize Device Blocks and Function Transfer Tables, 


Continued 


Initialization routine processing 


In initializing 


Device Blocks and Function Transfer Tables, ABIOS performs 


the following actions: 


| Step Description 


ABIOS Initialization 


COMPLETES THE FUNCTION TRANSFER TABLE 


When the operating system calls the Initialize Device Block and Func- 
al Transfer Table Routine, ABIOS Completes the Function Transfer 
able. 


=» The Function Transfer Table is completed at the location defined 
by the Function Transfer Table pointer in the Starting Logical ID 
parameter in Register DX. 


When the Initialize Device Block and Function Transfer Table routine 

is called for adapter ROMs or RAM extensions, each segment value 

that is placed in the Function Transfer Table must equal the seg- 

ib of its corresponding adapter ROM header or RAM extension 
eader. 


When the headers and segment values are equal, an operating 
system can access the Length Field (given in 512-byte blocks) of 
either the adapter ROM or RAM extension header so that the seg- 
ment limit can be determined in either bimodal or protected mode 
environments. 


When building the protected mode Common Data Area, if offset 0 
of the ROM header segment or RAM extension header segment 
contains the RAM or ROM signature, offset 2 will contain the length 
of the segment (in 512-byte blocks up to a maximum of 7Fh 


512-byte blocks). The operating system can use this value to calcu- 
late the segment limit. 


FILLS IN THE DEVICE BLOCK 


a. After completing the Function Transfer Table, the Initialize Device 
Block and Function Transfer Table Routine completes the Device 
ahs for the Starting Logical ID Parameter (which is contained in 


. The Initialize Device Block and Function Transfer Table Routine 
builds a Device Block for each Logical ID up to the Number of Logji- 
cal IDs To Initialize Parameter (this value is contained in CX). It 
may affect multiple services. 


la a 32-BIT DEVICE DATA POINTERS TO THE COMMON DATA 


a. ABIOS stores any Data Pointers associated with an ABIOS service 
“ any) into the appropriate Data Pointer field in the Common Data 
rea. 


. ABIOS increments the Data Pointer Count field as each Data Point- 
er is stored. 


. ABIOS stores a handle to the Data Pointer in the Device Block. 
This handle is an offset to the location in the Common Data Area 
where the Data Pointer is stored. 


continued 
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Step 4: Initialize Device Blocks and Function Transfer Tables, 
Continued 


How the operating system handles error conditions 


lf the Return Code Parameter (in AL) is not zero upon return from the Initial- 
ize Device Block and Function Transfer Table Routine, the operating system 
should deallocate the associated Device Blocks and Function Transfer Table 
Areas and replace the associated Device Block pointers and Function Trans- 
fer Table pointers with 0000:0000h, making all affected entries into null 
Common Data Area entries. 


Order of initialization 


The Initialize Device Block And Function Transfer Table Routines are called 
in the exact order that their respective pointers appear in the Initialization 
Table. The order of initialization is system board ROMs, adapter ROM exten- 
sions, and RAM extensions. | 


Because ABIOS services contained in system board ROMs are initialized first, 
the Initialize Device Block and Function Transfer Table routines for adapter 
ROM and RAM extension devices can then easily identify the system board 
device services they need. 


The initialization routines associated with edaetee ROMs and ABIOS RAM 
extensions must scan the Common Data Area using the Device ID in the 
public portion of the Device Block to identify the system board services that 
they need. Once the Device ID is found, the Logical ID, stored in the public 
portion of the Device Block, should be used for all additional requests to the 
system board ABIOS service. 


ABIOS services and initialization 


The operating system is free to decide not to initialize an ABIOS service 
based on the model, device, and revision information for each Initialization 
Table entry (OS/2 uses model and submodel number). If the operating 
system decides that this information indicates that the ABIOS code is not 
appropriate for current hardware, then the initialization of these ABIOS rou- 
tines may not be performed. Initialization routines are also free not to initial- 
ize themselves. 


continued 
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Step 4: Initialize Device Blocks and Function Transfer Tables, 
Continued 


Support for ABIOS extensions 


To properly support ABIOS extensions, the operating system must insure that 
all entries in the Initialization Table with the same Device ID and Secondary 
Device ID are initialized. 


Logical ID 02h initialization 


In the ABIOS system ROM, the code associated with the ABIOS Common 
Entry Routines is contained in the Device OOh service. The operating sys- 
tem always assigns Logical ID 02h to the system ROM Device OOh service. 
The process of initializing Logical ID 02h is a separate subject in itself and 
is discussed further in this chapter under the heading “Logical ID 02h 
Initialization. 


Physical addresses must be converted to segment:offset 


Unless they are altered by the operating system, all Data Pointer fields 
contained in the Common Data Area remain in 32-bit physical address 
format. Before calling the ABIOS, the operating system must translate the 
32-bit physical address of each data pointer into segment:offset format. 


Data Pointer/Pointer length facts 


Here are the most important things to remember about data pointers and 
data pointer lengths: 


» Data Pointers are stored in the ABIOS service as 32-bit physical ad- 
dresses in Intel low word/high word format. 

« The Initialization Routine initializes the Data Pointer field with this 32-bit 
physical address. 

« All Data Pointer fields in the Common Data Area are preceded by a Data 
Pointer Length Field. 

»« The Data Pointer Length field specifies the segment limit for a protected 
mode or bimodal environment. 

# In a bimodal environment, if the Data Pointer Length field is 0000:0000h 
in the real mode Common Data Area, then an address above 1 MB is 
assumed. 
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Step 5: Build Protected Mode Tables 


introduction 


In bimodal or protected mode environments, protected mode versions of the 
real mode Common Data Area and Function Transfer Tables must be built by 
the operating system. The operating system can use the information already 

gathered in the real mode Common Data Area and Function Transfer Tables 

to build these protected mode tables. 


Building the protected mode Common Data Area 


The protected mode Common Data Area and the protected mode Function 
Transfer Tables pointers are stored in protected mode selector:offset for— 
mat. The operating system must initialize all protected mode pointers so that 
their effective addresses are identical to their real mode, segment:offset 
counterparts. | 


The operating system must perform the following the steps in order to build 
the protected mode Common Data Area: 


| step | Description 
a Build the real mode Common Data Area. 


2 | Allocate memory for the protected mode Common Data Area. 


Allocate memory for the protected mode Function Transfer Tables. | 


Convert each real mode Device Block Pointer to a protected mode De- 
vice Block Pointer. 

Create a protected mode Function Transfer Table Pointer for each pro- 
tected mode Function Transfer Table. 

Convert each real mode Function Pointer within each real mode Function 
Transfer Table to a protected mode Function Pointer. 


Convert each real mode Data Pointer to a protected mode data pointer. 


continued 
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Step 5: Build Protected Mode Tables, Continued 


Building selector descriptors 


To build descriptors associated with each selector, the operating system 
must know 


» the actual physical address of the descriptor, 
=» the access rights of each segment, and 
=» the segment limits of each segment. 


Pointer characteristics 


The Function Transfer Table pointers and the Device Block pointers are data 
segment descriptors that can be written to by the operating system. The 
expansion direction and limit of each pointer must be maintained by the 
operating system. 


Function Transfer Table length and Device Block length are returned to the 
operating system via the Initialization Table. 


Each data pointer’s selector must reference a data segment descriptor that 
can be written to and has an expansion direction of up. Segment limit is 
stored in the Data Pointer Length Field associated with each Data Pointer 
entry in the Common Data Area. 


All Function Transfer Table pointers must be readable code segment descrip- 
tors. The Conforming Bit for each pointer is set by the operating system. 


If offset zero of either the ROM header segment or the RAM extension 
header segment contains the ROM/RAM signature, then offset 2 contains the 
length (in 512-byte increments with a limit of 7Fh) of the segment. This 
value should be used as the segment limit by the operating system. 


The segment limit for ROM/RAM signatures that do not exist must be FFFFh. 


Note: A complete description of both ROM and RAM extension headers is 
found in Chapter 7. 


continued 
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Step 5: Build Protected Mode Tables, Continued 


ABIOS I/O privileges 


The ABIOS must have I/O privilege at all times. Insuring ABIOS I/O privilege is 
the responsibility of the operating system, particularly when the operating 
system calls the ABIOS using multiple privilege levels or as a conforming 
code segment. 


Null Common Data Area entries 
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Each null entry in the real mode Common Data Area must have a corre- 
sponding null entry in the protected mode Common Data Area. 


When the protected mode version of each Function Transfer Table is initial- 
ized, each entry in the protected mode version that has a corresponding real 
mode entry equal to 0000:0000h must also equal 0000:0000h. 


The offset fields in the Function Transfer Table must be the same for the 
corresponding entries in both the real mode and the protected mode tables. 


The Device Block pointers for each Logical ID entry in both the real mode 
and the protected mode Common Data Areas must point to the same De- 
vice Block. 
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Initializing Logical ID 2: ABIOS Internal Calls 


Introduction 
The data structures associated with Logical ID 2 are reserved for ABIOS 
internal calls. 


How reserved Data Pointers are initialized 


Data Pointers 0, 1, and 2 in the Common Data area are initialized by Logical 
ID 2. The operating system initializes reserved Data Pointers in the Common 
Data Area when the Initialize Device Block and Function Transfer Table Rou- 


tine is called for Logical ID 2. 


The purpose of these data pointers is to allow a single common data pointer 
to be used in common by several ABIOS devices. The reserved data point- 


ers are: 


Data Pointer 
Number Physical Value Limit Description 


| 0 | 40h =~ ot00h_| BIOS Data Area 
me we E000:0000h FFFFh First 64K of System Board ROM 


How the Function Transfer Table is initialized 


po | F000:0000h FFFFh | Second 64K of System Board 


When the Initialize Device Block and Function Transfer Table Routine is called 


for Logical ID 2, this routine must perform the following actions: 


Common Start Routine the Start Routine pointer in the Function 
Transfer Table for Logical ID 2. 

Common Interrupt Routine the Interrupt Routine pointer in the Function 
Transfer Table for Logical ID 2. 

Common Time-out Routine the Time-out Routine pointer in the Function 

Pointers Transfer Table for Logical ID 2. 


continued 
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Initializing Logical ID 2: ABIOS Internal Calls, Continued 


Logical ID 2 Function Transfer Table entry 


The Initialization Table entry for the first Device ID that is a zero must have a 
Function Transfer Table length of 10h or greater, since the first 10h bytes 
are reserved. The Function Transfer Table length must be more than 10h if 
there are ABIOS internal functions. | 


The Function Transfer Table entry for Logical ID 2 is described in the 


following table: 
Description , | 


| 00h | 4 Bytes | Common Start Routine Pointer | 
| oan | 4 Bytes | Common interrupt Routine Pointer 
| 08h | 4 Bytes | Common Time-out Routine Pointer 
[oem | 2eytes | Reserved 
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How ABIOS Supports Multiple Instances of a Device 


When a service supports more than one device 


Once it has initialized all Device ID OOh structures, the operating system 
moves on to nonzero Device IDs, assigning Logical IDs ordinally. Occasion- 
ally, an ABIOS service supports more than one instance of a device. The 
number of Device Blocks required by the service depends on how the indi- 
vidual devices are distinguished. There are two cases. 


Case 1: Separate interrupt and arbitration levels 


Serial 
Port 1 


Common 
Data Area 


Serial Port Device 


bret LID nnh Service Block 
DB Pointer Function (Port 1) 
FTT Pointer Transfer 
Operating Table 
system 
Func. Oth Func. Oth 
LID nnh + 1 | Device 
ee DB Pointer Block 
| FTT Pointer (Port 2) 


Serial 
Port 2 


When multiple copies of a device require separate interrupt or arbitration 
levels, each device requires its own Device Block. Thus each device is 
logically identified with a separate Logical ID. Even though they require 
multiple Device Blocks and Logical IDs, each device must share the same 
device driver code. As such, the Function Transfer Table pointer associated 
with each Device Block can be initialized to point to the same structure. In 
other words, device services that support separate interrupt and arbitration — 
levels still only require one Function Transfer Table. 


The ABIOS Serial Port Service, for example, supports up to eight physical 
serial ports. Since each serial port requires a separate interrupt and arbitra- 
tion level, each serial port is associated with a separate Logical ID. The 
ABIOS Serial Port Service interfaces with up to eight Device Blocks; all Serial 
Port Service functions, however, are located by one Function Transfer Table. 


continued 
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How ABIOS Supports Multiple Instances of a Device, Continued 


Case 2: Share interrupt and arbitration levels | 


Request 
Block © 


Func. Oth 


Unit #1 


Operating 


Common Function Diskette Device 


Data Area Transfer Service Block 
Table 


System 


Request 
Block 


Func. Oth 


Unit #2 


When multiple copies of a device share the same interrupt and arbitration 
levels, they are distinguished from each other by the Device Block unit 
number field. Device Services of this type require only one Device Block, 
and one function Transfer Table. 


The ABIOS Diskette Service supports two physical diskette drives. Each 
diskette drive is identified by unit number. 
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Related Information 


Request Blocks 


In addition to the ABIOS data structures, the ABIOS also interfaces with 
RAM-resident parameter blocks, called Request Blocks. 


The ABIOS caller must initialize one Request Block per function call. The 
input, Output, and status parameters associated with a function call are 
stored in the Request Block dedicated to that call. Request Blocks associ- 
ated with completed function calls can be reused. 


For a complete discussion of Request Block structure, turn to Chapter 5. 


Transfer conventions 


Each time an ABIOS device function is called, the caller must build a func- 
tion-specific Request Block, push a set of pointers to the ABIOS Data Struc- 
tures onto the stack, and invoke the appropriate function entry routine. 


ABIOS functions can be called via either of two transfer conventions: the 
operating system transfer convention and the ABIOS transfer convention. The 
difference between these two conventions lies in the stack information and 
the entry routine called. 


For more information on how ABIOS functions are called, turn to Chapter 6. 


ABIOS extensions 


The discussion of ABIOS initialization presented in this chapter is kept on a 
fairly generic level. Although some mention was made of the process of 
initializing ABIOS extensions, the details of extension structure and require- 
ments was kept to a minimum. 


For more information on how ABIOS extensions, refer to Chapter 7. 
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Chapter 5 
Request Block Structure 


Overview 


Introduction 


Request Blocks are parameter blocks resident in system RAM which are 
created on demand by the operating system. There must be one Request 
Block per active ABIOS function request. 


Limits of this discussion 


This discussion is limited strictly to a definition of Request Block internal 
structure. The process of initializing and using Request Blocks is integrally 
related to the process of calling ABIOS functions. 


All discussion of Request Blocks beyond the definition of Request Block 
internal structures is found in Chapter 6 Calling ABIOS. 


continued 


Request Block Structure 119 


Overview, Continued © 


Summary of internal structure 


Request Block | 


Number: One per function 
request 


pectest = oo ena Kind: Parameter block 


Unit Access: ABIOS and Oper- 
ating System 


alg 
A 
oy 


Function 


Reserved Description: 
meseived a =| All input and output parame- 
Return Code F | Return Code ters are passed between the 
=| Time-out—s«|-s operating system and the 
ABIOS function via the Re- 
quest Block. 


So 
Oo 
3 


| 10h _| 


Request Blocks are built and 
Reserved controlled by the operating 


Data pointer 2 system. 
Because Request Blocks reside 
Relative block address in system RAM, input and out- 


Reserved SS =| put parameters are designated 
as offsets from the Request 
Block segment. 


Caching oS me Aled OOh-OEh are iad 
Bits 7-1= the same way across a 
BO axGecning: ABIOS functions. Offsets 10h- 
nie xxh bear definitions that are 
= function-specific. 


~~ 
© 
= 


N DN) = 
QO & > 
= 3 = zs 


Request Blocks associated with 
completed functions can be 
reused. 


In this chapter 


This chapter describes the internal structure of ABIOS Request Blocks. The 
following topics are presented: 


= Request Block Parameters 
=» Request Block Structure 
=» Error Codes 
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Request Block Parameters 


Types of Request Block parameters 
The Request Block has two types of parameters: 


= Functional Parameters 
» Service-Specific Parameters. 


Functional parameters 


Request Block functional parameters are the same for every ABIOS service 
request. Information about the service requested and the device to be called 
on is placed in these parameters by the caller and sent to the ABIOS. 


Each parameter is initialized by the caller and must not be changed while the 
request is being processed by the ABIOS, especially through multistaged 
ABIOS requests. The first 10h bytes in a Request Block are reserved for the 
Functional Parameters. See the Request Block Structure table in this chapter 
for a list of all Request Block functional parameters. 


Service-Specific parameters 


Request Block service-specific parameters may change with every ABIOS 
request. The information passed in these parameters varies with each type 
of ABIOS request. See the specific ABIOS service explanations in Chapters 8 
through 23 for detailed information about the contents of these parameters. 
see the Request Block Structure table in this chapter for a list of all Request 
Block service-specific parameters. 
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Request Block Structure 


Request Block structure table 


Input/ ‘ 
Output Bytes | Description 


FUNCTIONAL PARAMETERS 


REQUEST BLOCK LENGTH 


Contains the length in bytes of the Request Block. 
The maximum is 65,535. The caller initializes this 
field for a specific Logical ID. The ABIOS gives the 
size of the Request Block for a Logical ID in the 
Initialization Table. Function 01h, Return Logical ID 
Parameters, also gives the size, but the Request 
Block may actually be larger than the returned size 
from this function call. 


LOGICAL ID 


Specifies the particular device to be operated on for 
this service request. Used as an index to the Device 
Block/Function Transfer Table pair located in the 

Common Data Area. 


UNIT 
Addresses only a certain unit of a device within a 
Logical ID. The range of values for this field is spe- 
cific to each device that is identified as a Logical ID. 
The number of units attached to a single controller 
determines how many units are in a Logical ID. Units 
are numbered from zero, so the maximum unit num- 
ber is one less than the number of devices attached 
to the controller associated with this Logical ID. 


FUNCTION 


The entry in this field requests a particular ABIOS 

function. The following list details the common ABIOS 
functions. Refer to Chapter 8 for an example of how 
these are used in the Request Block. 


Description 
Default Interrupt Handler 
S 


Return Logical ID Parameters 


DD 
@o 
2] 
0) 
bm 3 
< 
oO 
2. 


| Function | 

| 00h 

| 02h 

| 03h | Read Device Parameters 
| 04h | Set Device Parameters 
| 05h | Reset/Initialize 

| 06h | Enable 

| 07h 
| 08h 
| 09h 


Write 


00h 
06h 
07h 
09h 
Additional Data Transfer 


OBh-FFh | Other service-specific functions 


D 
® | 
| 
oN Fox 
® 
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Request Block Structure, Continued 


Request Block structure table, cont’d 


Input/ 
Output | Bytes Description 


entire function request. For more information, see 


OCh Input/ 2 RETURN CODE 
Output 
the Return Code Handling heading in Chapter 3. 


Indicates the result of the current stage of the 
Output TIME-OUT 

The expected time that a requested stage will 

take. The time-out value is used to ensure that no 

operation or stage of an operation takes too much 

microprocessor time. 

This field is valid if the Return Code is Resume 

Stage after Time Delay (Bit 1 is set). 

This field is structured as follows: 

Bits 15-3 = Units of time before time-out (in 
seconds) 

CrP.” ae 2-0 = Reserved 


ABIOS function request. For single-stage requests 
) SERVICE SPECIFIC PARAMETERS SPECIFIC PARAMETERS 


or those requests in the final stage of a multistage 


request, this field indicates the final result of the 
12h Input DATA POINTER 1 

Contains a pointer to an I/O buffer used for this 
ABIOS request. The effective address, a 16-bit 
segment in the high word and a 16-bit offset in the 
low word, must be addressable from within the 
current mode of the microprocessor (real or pro- 
tected) when in a bimodal environment. 
The address may be: 
# a 32-bit physical address for DMA, or 
=» a segmented address for programmed 1|/O. 
The Return Logical ID Parameters Function (01h) 
returns a parameter (Transfer Data Pointer Mode) 
that indicates the mode (physical or logical) of the 

| data pointer for the 

| » Read (08h), 

» Write (09h), and 
» Additional Data Transfer (OAh) functions. 


continued 
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Request Block Structure, Continued 


Request Block structure table, cont’d 


Input/ 
Output | Bytes Description 


12h DATA POINTER 1, continued 

(cont'd) If the Transfer Data Pointer Mode Parameter 
specifies that this must be a logical pointer, Data 
Pointer 1 is a logical pointer and Data Pointer 2 is 
reserved. 
If the Transfer Data Pointer Mode Parameter 
specifies that this must be a physical pointer, Data 
Pointer 2 is a physical pointer and Data Pointer 1 is 
reserved. 
If the Transfer Data Pointer Mode parameter speci- 
fies that both a logical pointer and a physical point- 
er will be passed, Data Pointer 1 is the logical 

4 


pointer and Data pointer 2 is the physical pointer. 


If the Transfer Data Pointer Mode parameter speci- 
files none of the above, this Logical ID does not 
support functions 08h, 09h, and OAh, or these 
functions do not need address pointers, and no 
space will be allocated in the Request Block for any 
data pointers. | 


RESERVED | 
RESERVED 


DATA POINTER 2 | 
See Data Pointer 1 above. | 
SERVICE-SPECIFIC PARAMETERS 


Operands and the results of ABIOS functions may 
be communicated in these fields. Their contents 
depend on the device service and the requested 
function. See Chapters 8 through 23 for detailed 
descriptions, by service and function, of the con- 
tents of the service-specific parameter fields. 


WORK AREA 


Optional data area for ABIOS use only. User data 
may not be stored in this field. This field is not in- 
itialized. The caller must not alter the contents of 
this field, particularly while ABIOS is processing a 
multistaged request. | 


ee ee ee 

Sak Sout Ge 
input/ varies 
Output 
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Related Information 


Transfer conventions 


Each time an ABIOS device function is called, the caller must build a func- 
tion—specific Request Block, push a set of pointers to the ABIOS Data Struc- 
tures onto the stack, and invoke the appropriate function entry routine. 


ABIOS functions can be called via either of two transfer conventions: the 
operating system transfer convention and the ABIOS transfer convention. The 
difference between these two conventions lies in the stack information and 
the entry routine called. 


For more information on how ABIOS functions are called, turn to Chapter 6. 


Request Block handling 


Each time the caller builds a Request Block, the rules governing Request 
Block initialization and reuse must be observed. Because the rules for han- 
dling Request Blocks are so integrally related to the act of calling ABIOS 
functions, a complete discussion of the rules for handling Request Blocks are 
delineated in Chapter 6. 


Return Code handling 


The specifics of Return Code handling can be viewed as an integral part of 
calling ABIOS functions. A more detailed discussion of can be found in 
Chapter 6. 
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Chapter 6 
Calling ABIOS 


Overview 


Introduction 


This chapter describes the tasks, Conventions, and operating system 
responsibilities involved in calling ABIOS functions. 


In this chapter 
The following topics are presented: 
» ABIOS Processing Model 
# Request Block Initialization 
=» Transfer Conventions 
=» ABIOS Transfer Conventions 
=» Operating System Transfer Convention 
# Return Code Handling 
= Hardware Interrupt Handlers 
=» Default Interrupt Handler 
» Time-out Handler 
» ABIOS and Program Access 
» Accessing ABIOS via ABIOSCommoneEntry 
» Accessing ABIOS via ABIOSCall 
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ABIOS Processing Model 


Introduction 


When an operating system is interfaced with a ROM BIOS, care must be 
taken to insure that BIOS functions calls do not tie up the processor. In the 
ABIOS, this is accomplished by processing all functions that could potentially 
monopolize the processor time in multiple stages. 


How ABIOS processes functions 


The following illustration depicts the three ways ABIOS function calls are 
processed. 


7 ABIOS Processing Models 


SINGLE-STAGED FUNCTIONS 


: When processing single-staged functions, the ABIOS performs 
Complete input/output immediately and returns to the operating system. 
ABIOS requests that can be completed with a minimum of 

processor time are executed in this way. 


DISCRETE MULTISTAGED FUNCTIONS 


ABIOS functions that require a greater amount of processor 
time are processed in multiple stages. In discrete multistaged 
functions, the caller initiates input/output and returns to the 
operating system, moving from stage to stage until the func- 
tion call is complete. Discrete multistaged functions are driven 
from stage to stage by an interrupt from the device being 
eal or by the expiration of a function-requested time 
period. 


CONTINUOUS MULTISTAGED FUNCTIONS 


When processing continuous multistaged functions, ABIOS 
initiates input/output and returns to the operating system. 
Continuous multistaged functions can be considered “standing 

Start Stage requests” in that they never reach a completion point. Like 
discrete multistaged functions, they are driven from stage to 
stage by a hardware interrupt at the expiration of a function 
requested time period. 


How functions are interfaced 


In order to further liberate the processor, all function parameters are passed 
between the operating system and the ABIOS function via a function—specific 
parameter block, called the Request Block. Before starting a given ABIOS 
function, the operating system must initialize that function’s Request Block. 


continued 
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ABIOS Processing Model, Continued 


Return Codes: how function status is reported 


The ABIOS signals the status (Successful, unsuccessful, etc.) of a function 
stage by placing a Return Code in offset OCh of the Request Block. The 
ABIOS assumes that all Return Code handling is under the control of the 
operating system. 


What drives multistaged functions 


Multistaged functions are driven from stage to stage by either: 
=» A hardware interrupt or 
«= The elapse of a function requested period of time. 


Some multistaged functions are driven purely by hardware interrupt. Others 
are driven purely by time period. Others are driven by some combination of 
both hardware interrupt and time period. 


Interrupt-driven stages 


Each interrupt—driven ABIOS service is associated with one hardware interrupt 
level. The ABIOS assumes that all hardware interrupt handlers are under the 
control of the operating system. 


When a hardware interrupt occurs, the operating system must call the 
function associated with the interrupt so that the interrupting condition can 
be serviced. The ABIOS resets the interrupting condition at the hardware 
level. The operating system’s hardware interrupt handler must Penonn 
end-of-interrupt processing at the interrupt controller level. 


A service can have more than one active function request. When this hap- 
pens, the hardware interrupt handler must call each function until the ABIOS 
replies that the hardware interrupt has been serviced. 


continued 
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ABIOS Processing Model, Continued 


Time period driven stages 


Some ABIOS functions are driven from stage to stage by the elapse of a 
function—requested period of time. The ABIOS assumes that time-period _ 
stage handlers are under the control of the operating system. When a time 
period requested by the function expires, the operating system’s time period 
handler must call the given ABIOS function. 


Hardware interrupt stages and hardware time-out 


All hardware interrupt—driven stages of a function indicate a maximum time 
(in seconds) to wait for the hardware interrupt. The ABIOS assumes that all 
hardware time-out handlers are under the control of the operating system. 
Should the hardware time-out period associated with a given interrupt driven 
function elapse, the operating system is responsible for terminating the 
function and resetting the hardware. 


Hardware time-out vs. time period stages 


The terminology surrounding time period-driven stages and hardware time- 
out handling is similar. However, it is important not to confuse the process- 
ing associated with the hardware time-out handling and time-period stage 
handling. 


Hardware time-out handling is associated exclusively with those stages of a 

multistaged function that are driven by hardware interrupt and is designed to 
handle function termination cleanly. Execution of a time-out handling routine 
is symptomatic of a hardware error. 


Time-period handling is associated with those stages of a multistaged func- 
tion that are driven by time periods. Execution of a time-period handling 
routine indicates the elapse of a function—requested time delay and should 
not be associated with a hardware error. 


continued 
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ABIOS Processing Model, Continued 


How ABIOS functions are called 


Each ABIOS Service is associated with a set of function entry routines. There 
are three kinds of entry routines: 


= Start Routine 


The start routine associated with a service is called when a function is first 
started. 


= Interrupt Routine 


The Interrupt Routine associated with a service must be called when 
the function interrupts or when a time period-—driven function requires 
servicing. 

= Time-out Routine 


The Time—-out Routine associated with a service must be called when an 
interrupt—driven function suffers a hardware time-out. 


To reduce caller overhead, the ABIOS also contains a set of Common Entry 
Routines: a Common Start, Interrupt, and Time-out Routine. The Common 
Entry Routines do some initial processing then transfer control to the entry 
routine tied to the specific service. 


Conventions for calling ABIOS 


Whether it is a single-staged or a multistaged function, the caller has the 
option of starting functions via either of two conventions: the Operating 
System Transfer Convention or the ABIOS Transfer Convention. Each transfer 
convention is described in this chapter. 


Program accessibility 


The program accessibility of any ROM BIOS depends on the architecture of 
the operating system interfaced with the BIOS. 


Starting with IBM OS/2 Version 1.1, programs have full access to the ABIOS 
through the operating system via the IBM OS/2 DevHip services: ABIOSCom- 
monEntry and ABIOSCall. 


ABIOS accessibility for non-IBM versions of OS/2 varies from vendor to 
vendor. Programmers who are not using IBM OS/2 should refer to their 
OS/2 documentation to determine if their version of OS/2 supports program 
access to the ABIOS. 
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Request Block Initialization 


Description 


The Request Block, resident in system RAM, is a parameter block used to 
communicate information to and from the calling routine (usually the operat- 
ing system) and the ABIOS. Each ABIOS function is interfaced to its caller 
via a function—specific Request Block. The caller passes input parameters 
and the ABIOS passes output parameters and any other information concern- 
ing the completion state of a function through that function’s Request Block. 


Request Blocks and function requests 


The Request Block associated with a function must be initialized by the caller 
(usually the operating system) before the function can be started. 


When the operating system calls more than one function contained in the 
same ABIOS service, it must create one Request Block for each function 
requested. When each function is entered, the ABIOS references the serv- 
ice’s Device Block to determine the state of the device as it pertains to the 
function being processed. 


Defining Request Blocks 


The Request Block is defined differently for each ABIOS Service. The length 
of a Request Block is fixed for all functions numbered above Oth for a serv- 


ice. Request Block length is checked by ABIOS upon entry into an ABIOS 
function. | 


Request Block lifespan 


Once initialized, Request Blocks stay resident in system RAM for as long as 
the function call is active. Those Request Blocks associated with multistaged 
function stay resident in system RAM for the life of the function. Request 
Blocks associated with completed functions may be reused, or the memory 
they occupy can be deallocated. Reuse Request Blocks only if the Request 
Block length for the new function is the same or longer. 


continued 
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Request Block Initialization, Continued 


Rules governing Request Block use 


The general rules associated with Request Block use are illustrated below. 


INPUT Rules 


Request Block fields marked Reserved 
must be initialized to zeros. 


The content of input fields is not changed 


throughout a multistaged request. 


Initialize the Return Code to FFFFh before 
calling any ABIOS Start Routine. 


al ae [row WV [oo 
| 02h | Word | Logical ID 
| 04h | Word | Unit 
| 06h | Word | Function 
Ooh_f ners | Reseed 


Reserved 


2 es 

| Data pointer2_ 
Reserved : 
Relative block address 


{ | Reserved —s§.““lw | 
Number of blocks read 


Caching 


Bits 7-1 = Reserved 
Bit O = Caching 
O Yes 


1 No 
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Output fields need not be 
initialized 


The contents of an output 
field must not be altered 
during any stage of a 
multistaged request. 


Rules Governing 
Request Block Reuse 


Request Blocks associated 
with completed functions 
can be reused. 


Reuse Request Blocks only 
if the Request Block 
Length for the new func- 
tions is the same or 
larger. 


OUTPUT Rules 
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A Generalized Look at Control Transfer 


Introduction 


Once its Request Block has been initialized, the caller is free to transfer 
control to the ABIOS function. The process of transferring control to an 
ABIOS function is divided into two basic tasks: 


1. PUSH required entry pointers onto stack frame, 

2. CALL function entry routine. 

Control can be transferred to the function via the ABIOS Common Entry 
Routines or the ABIOS Service-Specific Entry Routines. The difference be- 


tween the two methods of calling ABIOS lies in the process used to locate 
pointers and load them onto the stack. 


Two tasks 


The graphic below details each control transfer task. 


| Control Transfer Tasks 


PUSH POINTERS ON STACK 


The caller pushes pointers to the Request : 

Block and the Common Data Area onto the | “4— Pointer to Common Data Area 
stack. Depending on which convention is used <q— Pointer to Request Block 

to transfer control to ABIOS, the caller may | ¢~— Pointer to Function Trans. Table 


optionally push pointers to the Function Trans- 
fer Table and Device Block. <¢— Pointer to Device Block 


TRANSFER CONTROL TO FUNCTION 


Baas i ila There are two kinds of function entry routines: 
ecuacaneentaie = ——— —j ®* Service-specific Entry Routines. 


*» Common Entry Routines 


oS : ae cas By convention, control can be transferred to a 

aM BASS ei given ABIOS function via either set of entry 

Function 00h routines. The ABIOS transfer convention indi- 

Function O1h cates that control be transferred to ABIOS 

laa ides the seg AU ley Routines. me 

perating System Transfer Convention indi- 

Function nnh Vector ——> cates that control be transferred to functions 
via the Service—Specific Entry Routines. 


continued 
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A Generalized Look at Control Transfer, Continued 


Common Entry Routine processing 


The Common Entry Routines — Start, Interrupt, and Time-out — provide the 
operating system with a common entry point to the ABIOS Service-Specific 
Entry Routines. The Common Entry Routines: 


Test the Logical ID field contained in the Request Block associated with 
the function being requested. If an invalid Logical ID is found, the Com- 
mon Entry Routine returns to the caller with the Return Code field set to 
CO00h Invalid Logical ID. The Logical ID input into the Common Data Area 
can be invalid for two reasons: 


= The Logical ID is greater than the count of Logical ID field contained in 
the Common Data Area, or 


» The Logical ID corresponds to a null Logical ID entry in the Common 
Data Area. (Logical IDs 0 and 1 are reserved). 


Index into the Common Data Area based on the Logical ID and the Anchor 
Pointer to determine which pair of Device Block and Function Transfer 
Table pointers are required. 


Copy the Device Block address into the stack placeholder. 
Copy the address into the Function Transfer Table stack placeholder. 
Transfer control to the Service-Specific Entry Routine. 


Service-Specific Entry Routine processing 


Every ABIOS service contains a set of service-specific entry routines — 
Start, Interrupt, and Time-out. The entry point to each of these routines is 
contained in the first three entries in the service’s Function Transfer Table. 


The Service—Specific Entry Routines: 


save the state of the registers, 

test the Request Block for valid function, 

test the Request Block for valid Unit Number (if any), and 
transfer control to function called. 


The function executes and returns to the operating system 
with a Return Code, and 


restores the state of the registers 
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ABIOS Transfer Convention 


ABIOS Transfer Convention 


Under the ABIOS Transfer Convention, the operating system loads the stack 
frame with pointers to the caller’s return address, Common Data Area, and 
Request Block. However, only placeholders are supplied for the pointers 
associated with the function’s Device Block and Function Transfer Table. | 


With the stack frame loaded, control is then transferred to the ABIOS func- 
tion via its Common Entry Routine. The Common Entry Routine fills in the 
placeholders in the stack frame then transfers control to the function via the 
function’s Service-Specific Entry Routine. 


Advantages 


From the caller’s point of view, the ABIOS Transfer Convention is the simpler 
of the two transfer conventions in that it reduces programming overhead 
when ABIOS functions are called in a bimodal environment. | 


Caller responsibilities on function return 


Once the function returns, the caller is responsible for 


= supplying error handling routines, and 
= removing arguments from the stack. 


Pseudocode 


The pseudocode below shows the suggested method for transferring control 
to an ABIOS function via the ABIOS Transfer Convention. 


PUSH Pointer to Anchor Pointer Segment or Selector 

PUSH Pointer to Request Block Segment or Selector 

PUSH Offset to Request Block 

SUB Stack Pointer, 8 

CALL Common Entry Routine (Start, Interrupt, or Time—out) 
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Operating System Transfer Convention 


The Operating System Transfer Convention 


Under the Operating System Transfer Convention, the operating system 
assumes the responsibility for loading the stack frame with pointers to the 
caller’s return address and to the Common Data Area, as well as to the 
function’s Request Block, its Device Block, and its Function Transfer Table. 
With the stack frame loaded, control is transferred to the ABIOS function via 
its service-specific entry routine. 


Two ways to load the stack frame 


OS 


The Operating System Transfer Convention supports two methods for loading 
the stack frame. 


= Direct CDA access method 
The caller indexes directly into the Common Data Area to locate the 
Device Block and Function Transfer Tables pointers associated with the 
Logical ID contained in the function’s Request Block. This is similar to the 
ABIOS Transfer Convention except that the Common Routines are not 
used, giving this method a slight performance edge. 


= Stored pointer method 
The caller (i.e. usually the operating system) stores the necessary point- 
ers and loads the stack frame directly without indexing the Common Data 
Area. 


Transfer Convention: Advantage #1 


The Operating System Transfer Convention involves more programming 
overhead, but may result in some improvement in speed of execution. This 
calling convention’s main advantage is realized in real mode only or pro- 
tected mode only operating environments. 


Where the ABIOS Transfer Convention relies on the Common Entry Routines 
to index into the Common Data Area to determine which Device Block/Func- 
tion Transfer Table pointer pair to use, there is a small performance disad- 
vantage to this method in a single mode environment. The Common Data 
Area is provided as an aid so that functions can be easily located in a 
bimodal environment. 


continued 
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Operating System Transfer Convention, Continued 


OS Transfer Convention: Advantage #2 


Whether the operating environment is single or bimodal, the Operating Sys- 
tem Transfer Convention is most effective when used to handle interrupts 
from programmed I/O devices (such as the keyboard controller) that are 
called repeatedly by a single function. 


Caller responsibilities on function return 


Once the function returns, the operating system is responsible for: 


= supplying error handling routines, and 
=" removing arguments from the stack 


Pseudocode 


The pseudocode below shows the suggested method for transferring control 
to an ABIOS function via the Operating System Transfer Convention. 


PUSH 
PUSH 
PUSH 
PUSH 


PUSH 
PUSH 
PUSH 
CALL 
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Pointer to Anchor Pointer Segment or Selector 
Pointer to Request Block Segment or Selector 
Offset to Request Block 

Pointer to Function Transfer Table Segment 

or Selector | 

Offset to Function Transfer Table 

Pointer to Device Block Segment or Selector 
Offset to Device Block 

Service-Specific Entry Routine 

(Start, Interrupt, or Time-out) 
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Return Code Handling 


Introduction 


ABIOS signals the status (successful, unsuccessful, etc.) of a function call 
by writing a Return Code to offset OCh of the function’s Request Block. The 
ABIOS assumes that all Return Code handlers are under the control of the 
operating system. 


Return Code bit testing 


The operating system’s Return Code Handling routine should always test 
certain Return Code bits. Depending on the settings for bits 15, 13, 12, and 
8, all other bits, including some bits marked reserved, may be meaningful. 


Return Code bit definitions 


The following table lists the primary and secondary definitions for Return 
Code bit settings. 


| ets | Primary Definition | Secondary Detinition 
a 
[14 [Parameter veri None 
[13 | time-out eror SNe 
[8 | retryabie error ——=~S~S*diC pio ero 
a 
— 
a 
-—_2ae 
ie ce 


[Resume Stage after iterupt_ | Devie-speciie error | 


Bits 14-8 take the Primary Definition only when Bit 15 is set. 


2. Bits 11-0 take the Secondary Definition only when Bit 15 is on and any | 
combination of bits 13, 12, and 8 are also on. 


3. Bits 7-0 take the Primary Definition only when Bit 15 is not on. 
If all bits are on, this Request Block has not been processed yet. 


continued 
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Return Code Handling, Continued 


Flow chart 


The following flow chart shows a method of testing the Return Code field. 


Successful 
operation 


Device in use, re- 
quest refused. If 


bits 11-0 on, de- 
vice-specific error. | 
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No" allbitson ~>NSe 


| Yes 


Request Block not 
processed yet. 


“Yes 
Bit 14 on > 
° 


Bit 13 on 


Bit 12 on 


Bit 15 on 


Unsuccessful 
operation 


Parameter Error. Re- 
quest Block coded in- 
correctly. Range — 
C000h-C020h. 


Time-out Error. See 
bits 11-0 for 


’ device-specific error 


code. Test bits 12 
and 8 also. Range — 


| AOOOh-FEFFh. 


Device Error. See 
bits 11-0 for device- 


| specific error code. 


Test bits 13 and 8 
also. Range — 


| 9000h-FEFFh 


Retryable Error. See 


| bits 11-0 for device- 
| specific error code. 


Test bits 13 and 12 
also. Range — 


| 8100h-FEFFh 


Request in progress. 
Check bits 3-0 for 
reason. Range — 
0001-/7FFFh. 


| Start 
again 


| Start 
: again / 


| Start 
. again 


_/f Start 
ee again _ 
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Return Code Handling, Continued 


Return codes 


The following table contains a general listing of the ABIOS Return Codes. 
ABIOS may generate any value that can occur in a 16-bit ABIOS field, so all 
operating system routines that test ABIOS Return Codes should be prepared 
for any value. That is, each bit in the Return Code field should be tested. 


Code Description 


0000h Successful 
Resume Stage after Interrupt 
0002h Resume Stage after Time Delay 


Not My Interrupt, Resume Stage after Interrupt 


0009h 
0081h 
8000h 
8001h-8FFFh 
9000h-90FFh 
9100h-91FFh Retryable Device Error 
9200h-9FFFh | Device Error 
A000h-AO0FFh 
A100h-A1FFh 
A200h-AFFFh 
BOOOh-BOFFh 
B100h-B1FFh 
B200h-BFFFh 
Co00h 
Cooth 
\ C002h 
C003h 
C004h 
C005h-C01Fh 
C020h-FFFEh Service-—Specific Unsuccessful Operation 
FFFFh Return Code Field Not Valid 


Attention, Resume Stage after Interrupt 
Unexpected Reset, Resume Stage after Interrupt 
Device in Use, Request Refused 


Service-Specific Unsuccessful Operation 


Device Error 


Time-out Error 

Retryable Time-out Error 
Time-out Error 

Device Error With Time-out 
Retryable Device Error With Time-out 
Device Error With Time-out 
Invalid Logical ID 

Invalid Function 

Reserved 

Invalid Unit Number 

Invalid Request Block Length 


Invalid Service-Specific Parameter 
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Hardware Interrupt Handlers 


Introduction 


The ABIOS assumes that the operating system provides hardware interrupt 
handlers that receive control via a hardware interrupt vector. 


Logical IDs and the hardware interrupt handler 


Once ABIOS initialization is complete, all ABIOS services are identified to the 
operating system by unique Logical ID. The operating system’s hardware 
interrupt handler must keep track of the Logical IDs that operate on each 
interrupt level. And it must maintain the validity of all Request Block pointers 
currently tied to each Logical ID. 


When a hardware interrupt occurs, the ABIOS Common Entry and Service- 
Specific Entry Routines, in turn, provide the operating system with a way to 
transfer control to the given ABIOS service. 


Request Block polling 
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When a given hardware interrupt occurs, a Logical ID may have more than 
one active Request Block. The operating system’s hardware interrupt handler 
must process each active Request Block by calling the ABIOS service in- 
volved at its Interrupt Routine entry point. Depending on the transfer conven- 
tion used, this can be done through either the common interrupt routine or 
through a service-specific interrupt routine. 


If bit O of the Return Code field is set, the Request Block is waiting for an 
interrupt. As the hardware interrupt handler polls each Request Block, the 
ABIOS is responsible for setting the Return Code field to indicate whether or 
not the hardware interrupt was associated with the given Request Block. 


The operating system’s interrupt handler can call the ABIOS with interrupts 
either enabled or disabled. If interrupts must be disabled, the ABIOS restores 
the state of the interrupt flag when interrupts are disabled and re-enabled. 


continued 
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Hardware Interrupt Handlers, Continued 


Initializing the Return Code Field before starting functions 


The operating system should always initialize the Return Code field in a 
Request Block to FFFFh before calling the start routine. 


lf there is an outstanding Request Block at interrupt time, the operating 
system must first see if the Return Code field is FFFFn. If it is, the hardware 
interrupt handler must not attempt to resume this request. In this way, the 
ABIOS can process the function request and set the Return Code appropri- 
ately when the interrupt is executed. 


Preventing interruption of a routine while it is being started 


When a Start Routine transfers control to a function, it does not reset the 
registers to their pre—call state until the function returns with a valid (i.e. 
other than FFFFh) Return Code. 


When an interrupt occurs before a Start Routine has interrogated the Return 
Code field and reset the register state, it is possible for the Start Routine 
and an Interrupt Routine to be accessing the same Request Block from within 
different stack frames. 


To prevent this, the operating system should maintain a flag to indicate 
whether or not a Start Routine has processed completely. An Interrupt 
Routine should not be allowed to call a function until its Start Routine has 
finished execution. 


ABIOS processing 


If the interrupt is not associated with the Request Block being polled, the 
ABIOS generates the Return Code 0005h Not My Interrupt, Resume Stage 
After Interrupt. 


When the interrupt is associated with the Request Block being polled, the 
ABIOS: 
=" processes the interrupt, 


= resets the device condition causing the interrupt at the device /eve/, The 
return code handler routine and 
= returns to the caller via the Request Block with an updated Return Code. 


continued 
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Hardware Interrupt Handlers, Continued 


End-of-interrupt (EOI) processing 


Although it resets the interrupting condition at the device, the ABIOS does 
not reset the interrupt controller. Therefore, all end of interrupt processing 
must be handled by the operating system at the interrupt controller. 


Once all Request Blocks for a given Logical ID have been processed through 
the operating system’s hardware interrupt handler and at least one Request 
Block responds that the interrupt was serviced, the operating system is free 
to reset the interrupt controller. 


The ABIOS informs the caller that a Request Block has been serviced by 
placing any value other than 0005h Not My Interrupt, Resume Stage After 
Interrupt into the Request Block’s Return Code field (offset OCh). 


Default interrupt handler. 


If the hardware interrupt handler has called all Request Blocks waiting on an 
interrupt level and none have “claimed” the interrupt (i.e. sent a Return 
Code other than O005h Not My Interrupt, Resume Stage after Interrupt), a 
rogue interrupt has occurred. 


The hardware interrupt handler should call each Default Interrupt Handler for 
each Logical ID using the interrupt level. For more information on the Default 
Interrupt Handler see the next topic in this chapter. 


Interrupt sharing 


No Logical ID can operate on more than one interrupt level. Logical IDs with 
multiple units operate on the same interrupt level. 


Should more than one Logical ID or Logical ID/Unit combination share the 
same interrupt level, the hardware interrupt handler associated with that 
interrupt level should repeat the polling process until all the Logical IDs are 
processed, or until one Logical ID is processed to completion. 


continued 


144 ABIOS for IBM PS/2 Computers and Compatibles 


Hardware Interrupt Handlers, Continued 


Interrupt sharing 


The graphic below depicts the situation where more than one Request Block 
is active on a given Logical ID. 


Pp interrupt Flow Pp interrupt Flow 


Request Block 


Return Code 
0001h 


ABIOS 
Service 


Hardware 


Request Block Device 


Return Code 
0001h 


Request Block 


Return Code 
0001h 


IRQ Line 


Pons Operating System 
Logical ID “n Interrupt Service 
Routine 


Logical ID “n+1” 
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Hardware Interrupt Handlers, Continued 


ABIOS bimodal support for interrupt handlers 


When operating in a bimodal environment, it is possible for one Logical ID 
(i.e. one ABIOS service) to be associated with a number of real mode and 
protected mode function requests. 


When this is the case, the ABIOS supports hardware interrupt handlers in the 
following way: 7 


= Microprocessor mode is maintained 
After a function polls its hardware interrupt handler, the ABIOS is returned 
to the microprocessor mode that was in effect before the hardware inter- 
rupt call was made. 


= Interrupt routine can be called bimodally 

When servicing the next Request Block, the hardware interrupt handler 
calls the interrupt routine from the current mode in effect. The micropro- 
cessor mode is hidden from the ABIOS. Control is transferred to the next 
function called whether or not that function was originally started in the 
Current mode. For example, if the system is operating in real mode, the 
hardware interrupt handler can call a function that was initiated in pro- 
tected mode. 
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Default Interrupt Handler 


Description 


Each ABIOS service that uses hardware interrupts contains a Default Interrupt 
Handler. The Default Interrupt Handler resets the interrupting Condition at the 
device level when a hardware device generates an unexpected interrupt. 


Determining which services contain Default Interrupt Handlers 


To determine whether or not a given Logical ID (ABIOS service) contains a 
Default Interrupt Handler, place a call to function O1h Return Logical ID 
Parameters to determine the Logical ID. 


The value returned in the Request Block at offset 10h will indicate whether or 
not the Default Interrupt Handler is supported. The values may be: 


Return Code Description 
FFh Default Interrupt Handler is not supported | 


FEh Reserved for NMI Service. 
Default Interrupt Handler is not supported | 
Default Interrupt Handler supported for this Logical 
ID, where nnh = hardware interrupt level. 


How the Default Interrupt Handler is invoked 


When an interrupt occurs while there are no active Request Blocks, the 
operating system must 


= build the Default Interrupt Handler’s Request Block, 
# load the stack frame with the appropriate pointers, 


= call either the Common Interrupt Routine or Service-Specific Interrupt 
Routine, depending on the transfer convention being used. The Default 
Interrupt Handler resets the unexpected interrupt at the device level, and 


=" upon return, the operating system performs EOI! processing, resetting the 
interrupt at the interrupt controller. 


continued 


Calling ABIOS 147 


Default Interrupt Handler, Continued 


Request Block Structure 


The structure of the Default Interrupt Handler’s Request Block is described in 
the table below: 


| 02h | Word || Logical ID CdS 
et ee ee 
| 08h | Word | Reserved (initialize to 0000h : : 


Return Codes 


The Default Interrupt Handler Return Codes are listed in the table below: 


0000h Successful Operation 
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Time-Out Handlers 


Introduction 


The ABIOS informs the operating system of the maximum period it is to wait 
for a hardware interrupt—driven stage by outputting a value (in seconds) to 
the the time-out field (offset OEh) in the function’s Request Block. The 
ABIOS assumes that all hardware time-out handlers are under the control of 
the operating system. 


A time-out value of OOh indicates no time-out checking should be done by 
the caller. The keyboard is an example of a device for which the ABIOS 
device service is willing to wait forever for the next interrupt. 


Time-out handler duties 


The operating system’s time-out handler must refer to function time-out 
value and set up a function—specific time-out counter. If the hardware inter- 
rupt associated with a given function does not occur in this amount of time, 
the time-out handler transfers control to the ABIOS Time-Out Routine. The 
Time-—Out Routine disables further interrupts for the device, aborts the func- 
tion. and cleanly returns control to the operating system. 


Either transfer convention will do 


Depending on the transfer convention used, the operating system's time-out 
handler can handle hardware time-outs via either the Common Interrupt 
Routine or through a Service—Specific Interrupt Routine. 


continued 
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Time-Out Handlers, Continued 


Time-out Routine vs. Resume Stage after Time Delay value 


It is important not to confuse the processing associated with the Time-out 
Routine with the processing associated with the Resume Stage After Time 
Delay value (Return Code 0002h) returned by the ABIOS for those stages of 
a function that are driven by a function—requested time delay. 


The ABIOS Time-out Routine is associated exclusively with those stages of a 
multistage function that are driven by hardware interrupts. It is designed to 
handle function termination cleanly. 


The Resume Stage after Time Delay (Return Code 0002h) value is associ- 
ated exclusively with those stages of a multistaged function that are not 
driven by a hardware interrupt. Error handling resulting from this stage is 
handled by the ABIOS function itself. Generally, the function indicates an 
error in a time delay—driven stage by returning a Return Code of 0002h to its 
Request Block. 
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ABIOS and Program Access 


Introduction 


For now, OS/2 is the primary operating system using ABIOS. OS/2 itself 
provides end user programs with powerful functionality which makes bypass- 
ing the operating system in favor of the ABIOS largely unnecessary. How- 
ever, the need may arise for the greater hardware control provided by direct 
access to the ABIOS Services. 


The Anchor Pointer, OS/2, and program access 


When ABIOS is initialized under OS/2, the segment address of the Common 
Data Area is stored by the operating system in a non-public variable called 

the Anchor Pointer. See Chapter 3 for more information about Anchor Point- 
ers and public and private data. 


Control cannot be transferred to an ABIOS function without first accessing 
the information contained in the Common Data Area. Therefore, access to 
the ABIOS is impossible from a program running under OS/2 unless it is 
supported by the operating system. 


IBM OS/2 allows program access to ABIOS 


Although it does not make the Anchor Pointer public, IBM OS/2 (versions 
1.1 and beyond), support program access of the ABIOS via two OS/2 
DevHip services: ABIOSCommonEntry and ABIOSCall. 


Programmers who are not using IBM OS/2 should refer to their OS/2 docu- 
mentation to determine if their version of OS/2 supports direct access to the 
ABIOS. 
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Accessing ABIOS via ABIOSCommonEntry 


Description 


The IBM OS/2 service ABIOSCommonEntry is used to call an ABIOS 
functions via the ABIOS Transfer Convention, that is to say via the ABIOS 
Common Entry Routines. 


ABlIOSCommonEntry initializes the stack frame with pointers in the format 
required by the current processor mode. Then it calls the Common Entry 
Routine specified in DH. On return, ABIOSCommoneEntry cleans up the stack 
before returning to the caller. 


Caller must locate Logical ID 


Before invoking ABIOSCommonEntry, the caller must first initialize the Re- 
quest Block associated with the ABIOS function to be called. Since a serv- 
ice’s Logical ID is a mandatory input into each function Request Block, the 
caller is responsible for determining the Logical ID assigned to the service 
being called. 


Locating Logical ID via function Oth 


Because the Anchor Pointer to the Common Data Area is a non public 
variable, the only way for the caller to determine a service’s Logical ID is 
to invoke function 01h Return Logical ID Parameters for each ou in the 
Common Data Area. 


To do this, the caller must use ABIOSCommonEntry to invoke function Oth, 
Return Logical ID Parameters for Logical IDs 03h to nnh. The Request Block 
associated with function O1h of each ABIOS service is fixed at 20h bytes. 
When called, function 01h returns to offset 12h the hardware Device ID 
associated with the service. From this value, the caller can determine which 
device service is linked to a given Logical ID. 


continued 
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Accessing ABIOS via ABIOSCommonEntry, Continued 


ABIOS supported devices 


The ABIOS supports 16 kinds of physical devices. There is one ABIOS device 
service for each device. The table below lists the physical device ID and the 
ABIOS device services tied to those devices. 


Device ID | Device Type/Service | Device ID | Device Type/Service 


ABIOSCommonEntry Input/Output 


Input: 


MOV SI, Request_Block Offset ; 


MOV DH, Which Com Routine 


MOV DL, DevHlp_ABIOSCommonEntry 


e 
’ 


y 


CALL [Device Help] 


Output: 
CF 


AX 


Calling ABIOS 


Offset in DS of Request Block 
Indicate in DH which Common 
Routine to call, where: 


OOh = Common Start Routine 
Olh = Common Interrupt Routine 
02h = Common Time-—out Routine 


O If call was successful 


1 If error occurred 
Error Code 
ABIOS not present. 


Unknown ABIOS command. 


continued 
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Accessing ABIOS via ABIOSCommonEntry, Continued 


To avoid suspension in the background 


_ ABIOS functions can sometimes be suspended if the operating environment 
is shifted from OS/2 mode to the DOS compatibility box. This occurs when 
functions executed in the DOS compatibility box put the service’s operating 
environment is a state that is unknown to the function called in OS/2 mode. 


ROMCritSection sets a flag that prevents entry into the DOS compatibility 
box until the function called via ABLIOSCommonEntry has executed to com- 
pletion. Since there is no way to determine in advance whether or not a 
function is susceptible to suspension, the caller has two choices: 


= call OS/2 ROMCritSection before calling ABIOSCommonEntry, or 


» test the function by calling it via ABIOSCommoneEntry and switching to the 
DOS compatibility box. | | 


lf ROMCritSection is called to prevent entry into the DOS compatibility box, 


then it must be called again after the ABIOS function completes to re-enable 
entry. 


ROMCritSection Input/Output 


DS must point to the ABIOS Device Driver’s data segment. Reset DS if it has 
been previously used in a PhysTovVirt call. . | 


MOV AL, enter_or exit s;Critical Section Flag 
- = 0 exit 
; < > 0O enter 

MOV DL,DevHlp_ROMCritSection 

CALL [Device Help] 


For more information 


For more information on calling ABIOS functions via ABIOSCommonEntry, 
refer to [BM Operating System/2 Technical Reference, Volume 1. 
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Accessing ABIOS via ABIOSCall 


Description 


The IBM OS/2 service ABIOSCall is used to call an ABIOS functions via the 
Operating System Transfer Convention via the ABIOS Service-—Specific Entry 
Routines. 


ABIOSCall initializes the stack frame with pointers in the format required by 
the current processor mode. Then, it calls the Service-Specific Entry Routine 
specified in DH. On return, ABIOSCall cleans up the stack before returning 
to the caller. | 


ABIOSCall Input/Output 


Input: 

MOV AX, LID -Service’s Logical ID 

MOV SI,RB Offset . ‘Data Segment DS offset to 
‘caller’s Request Block 

MOV DH,Entry_Point ;Service-—Specific Routine 


‘OOh = Start Routine 
-Olh Interrupt Routine 
‘O2h = Time-—out Routine 


MOV DL,DevHlp_ ABIOSCall 
CALL [Device Help] 


Output: 
CF 


O If call was successful 

1 If error occurred 

AX = Error Code 

ABIOS not present. 
Unknown ABIOS command. 


To avoid suspension in the background 


ABIOS functions can sometimes be suspended if the operating environment 
is shifted from OS/2 mode to the DOS compatibility box. To avoid this, the 
caller should call OS/2 ROMCritSection before calling ABLOSCommonEntry. 
The method for doing this is described on the previous page. 
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Chapter 7 
ABIOS Extensions 


Overview 


Introduction 


In general, how a given BIOS extension is implemented depends on the 
nature of the BlIOS-to-—operating system interface. 


BIOS extensions in PC XT/AT systems 


In IBM PC XT/AT-compatible environments, system hardware is isolated 
from the operating system (typically MS- or PC-DOS) by a ROM-based 
BIOS, such as the Phoenix AT-compatible BIOS. 


Under DOS, ROM BIOS interrupt vectors and data structures are publicly 
accessible. As a result, system hardware or software enhancements that 
require extensions to the BIOS are typically implemented by intercepting an 
existing software interrupt. Since BIOS data is public, BIOS extensions of this 
type are free to use existing BIOS data or to create data structures of their 
own. 


continued 
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Overview, Continued 


CBIOS extensions in PS/2-compatible systems 


In MCA-based PS/2-compatibles, the CBIOS portion of the ROM BIOS iso- 
lates single-tasking operating systems (such as MS- or PC-DOS) from 
system hardware in the same way the BIOS isolates DOS from the hardware 
in PC XT/AT-—compatible systems. Extensions to the CBIOS/DOS interface are 
implemented exactly as they are in PC XT/AT-compatible systems. 


ABIOS extensions 
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When a multitasking operating system (such as OS/2) is interfaced with a 
PS/2-compatible system, that operating system interfaces with the ABIOS 
portion of the ROM BIOS. 


Under OS/2, however, ABIOS data structure addresses and service/function 
entry points are only known to the operating system. Because of this, en- 


hancements to system software or hardware that require ABIOS extensions 
must insure that: 


» the undefined interstage state information and work areas contained in the 
pre-existing service’s Device Block are not overwritten, 
» the extension maintains control of all function entry points, and 


# the extension will only be initialized if its revision level is greater than the 
revision level of the pre-existing service. 


continued 
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Overview, Continued 


Summary of requirements 


To ensure each of the above considerations, all ABIOS extensions must meet 
the requirements outlined in the illustration below: 


Extension Requirement 1: File Header 


All ABIOS extension routines must be identified to 
the system via an extension file header. 


Service 


init. code 


Requirement 2: Routine to Build Initialization 
common Table Entry 


code ABIOS extensions must contain a routine that 
can be called during the ABIOS initialization proc- 
ess to build the extension’s entry into the ABIOS 
Initialization Table. 


Requirement 3: Routine to Build DB and FIT 
entry int. 


routines routine All ABIOS extensions must contain a routine to 
initialize an extension-specific Device Block (DB) 
time-out and Function Transfer Table (FTT). 


routine 


start 
routine 


func. 1 
start Requirement 4: Service Code 


func. 2. | | Each ABIOS service must contain 


start « A complete set of extension-specific entry 
routines. 


function func. 3 » Run time code to service a device. 
starts start 


continued 
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Overview, Continued 


Two types of ABIOS implementations 


As long as it meets the four requirements for creating valid ABIOS exten- 
sions, an extension can be implemented either in ROM or in RAM. 


The differences between the two types of implementations are described 


below. 


ROM extension 


RAM extension 
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ABIOS ROM extensions: 


» Exist in the same peripheral card ROM that contains 
their CBIOS counterparts. 


» Contain manufacturer-specific ABIOS device services. 


e Are located and initialized as part of the overall ABIOS 
ROM initialization process. 


ABIOS RAM extensions exist as files that will be located 
and initialized into system RAM during the overall ABIOS 
ROM initialization process. If they are to be implemented 
under OS/2, extension file names must be listed in the 
file ABIOS.SYS. The following facts apply: 


» ABIOS.SYS must contain a list of filespecs separated 
by either blanks or new lines. 


» Both ABIOS.SYS and any files listed in ABIOS.SYS 
a reside in the root directory of the OS/2 IPL 
volume. 


« The files listed in ABIOS.SYS are loaded into memory 
in the order in which they are listed. 


» The sector size of all RAM extension files must be a 
multiple of 512K. 


» All ABIOS RAM extension files must have a .BIO 
extension. 


RAM extensions are loaded after ROM extensions. 


continued 
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Overview, Continued 


In this chapter 
This chapter explains how to implement ABIOS extensions. 


Topics presented 
The following topics are presented: 
= Recommendations for extending ABIOS 
» Requirement 1: ABIOS Extension Header Formats 
» Requirement 2: Build Initialization Table Routine 
» Requirement 3: Build Device Block and Function Transfer Table Routine 
» Requirement 4: ABIOS Function Code 
» Initialization: ABIOS ROM Extensions 
= Initialization: ABIOS RAM Extensions 
» Examples: Introduction 
» Example 1: Non-Intrusive Interception 
» Example 2: Redirection of a Nonstaged Function 
» Example 3: Redirection of a Staged Function 
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Recommendations for Extending ABIOS 


Background 


IBM suggests in its document, Advanced BIOS Supplement for the Personal 
System/2 and Personal Computer BIOS Interface Technical Reference, that an 
ABIOS extension may: 


» ADD a completely new device service. 

» REPLACE an existing device service. 

» PATCH revised function support into an existing davies service. 
» EXTEND new function support to an existing device service. 


Why patching and extending are not recommended 


In its definition for ABIOS extensions that patch or extend device services, 
IBM suggests that such function-level ABIOS extensions can be implemented 
by changing the vectors to function starts in the Function Transfer Table 
used by the previous service. 


There are two problems with this approach to function-level extensions: 


= Start replacement does not accommodate interstage data 


If the start of a staged function is replaced, interrupt and time-out han- 
dling associated with this function must also be replaced (because the 
extension and the previous service may use interstage state information 
differently). There are no public vectors to an individual function’s inter- 
rupt and time-out handling. 


m Stack and register contents are not defined 


| Stack and register contents passed to individual function starts are not 
defined by IBM and are presumably subject to change. Therefore, a start 
routine in one service doesn’t know how to pass control to an individual 


function start in another service, and the function start doesn’t know how 
to return. 


continued 
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Recommendations for Extending ABIOS, Continued 


Phoenix recommendations 


Phoenix Technologies Ltd. recommends that function-level extensions to the 
ABIOS fall under the single class: MODIFY. Extensions that modify ABIOS 
services on the function level must carefully conform to the requirements set 
down in this chapter. The requirements insure that: 

= Device Block private data is not overwritten 


The Device Blocks associated with all ABIOS services contain a substantial 


amount of “private” data that is neither publicly defined nor publicly 
accessible. 


mw Interstage state information is not lost 


Interstage state information is not defined. Therefore, if an extension 
performs any stage of a particular function or a particular call, it must 
perform all stages. 


Phoenix terminology 


When handled in this way. ABIOS extensions fall into three categories: RE- 
PLACE, ADD, and MODIFY. As a general rule, the extent of change between 
the pre-existing service and the extension service should help determine 
which extension type is required. 


Graphic examples 


The following illustrations graphically depict how extensions that REPLACE, 
ADD, or MODIFY might interface with fixed disk hardware. 


continued 
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Recommendations for Extending ABIOS, Continued 


ABIOS extensions that REPLACE services 


ABIOS extensions that replace an existing service completely supersede that 
service. 


Operating System 


REPLACE Service 


Fixed Disk Fixed Disk 
Service Service 


ommoy common 
X code | code 
\2/ start 

routine 

int 
routine 
time-out Fixed Disk 
routine 


{init coad 


func. 1 
start 


func. n 
start 


The REPLACE option and ABIOS Data Structures 


ABIOS extensions that replace existing services require an all new Device 
Block and Function Transfer Table. At initialization, the Common Data Area 
pointers to the “old” service’s Device Block and Function Transfer Table are 
zeroed, thus nullifying all calls to the older service. 


continued 
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Recommendations for Extending ABIOS, Continued 


ABIOS extensions that ADD services 


ABIOS extensions that add a service are similar to those extensions that 
replace a service, but differ in one critical respect. ABIOS extensions that 
add a service do not supersede any pre-existing service. 


Operating System 


ADD Service 


Fixed Disk 
Service 2 


init code 
common 
cod 
start 
routine 
in 
routine 


e 
t. 

Simeeaut Fixed Disk 

(new hardware) 

init code func. 1 

com start 
cod : 
in 


mon 
e 
start func. n 
routine start 
t. 

: Fixed Disk 
time-out “ x 
routine (“old” hardware) 


The ADD option and ABIOS Data Structures 


ABIOS extensions that add a new, coexistent device service require an all 
new Device Block and Function Transfer Table. At initialization, each device 
service is assigned its own Logical ID. Function calls to each service are 
distinguished from each other by Logical ID. 


continued 
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Recommendations for Extending ABIOS, Continued 


ABIOS extensions that MODIFY services 


When the degree of change between a pre-existing ABIOS service and the 
extension is small, the ABIOS service can be modified by creating an exten- 
sion that shares duties with the pre-existing service. 


Operating System 


MODIFY Service 


Fixed Disk 
Service 


init code init code 
common common 
code code code 
ri start start 
routine routine routine 
int. int. int 
tine routine 7 
rou routine 


e 
time-out time-out time-out 
routine routine routine 


Old code func 1 func. 1 func. 1 
start start start 


func. n func. n func. n 


Fixed Disk 


continued 
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Recommendations for Extending ABIOS, Continued 


The MODIFY option and ABIOS Data Structures 


ABIOS extensions that share functionality with an existing service require a 
“hybrid” Device Block and a new Function Transfer Table. At initialization, 
the Common Data Area pointers to the “old” device service data structures 
are nullified. All function calls are relayed via a new Logical ID associated 
with the modified service. 


The new Function Transfer Table directs all functions to the new service, 
where a decision to revector certain functions to the “old” service may be 
made. The private Device Block parts reserved by the “old” service must 
not be written to by the new service; private data may not be shared be- 
tween services. 
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Requirement 1: Create Proper Extension Header 


Introduction 


ABIOS extensions are identified to the system by an extension file header. 
The format of this header varies depending on whether the extension is to 
be implemented in ROM or RAM. 


ROM extension file header 
The ROM extension file header is described in the table below. 


EXTENSION ROM SIGNATURE = AAS5h 
Extension ROMs may contain extensions to either (or both) 
the CBIOS and the ABIOS. The power-on self test (POST) 
searches for CBIOS extension ROMs in 2K increments over the 
wiki 
P| 
06h 2 
ture indicates that the ROM contains an ABIOS extension. The 
ABIOS Extension Signature must be set to BB66h. 
08h 1 NUMBER OF ENTRIES TO ADD TO INITIALIZATION TABLE 
The total number of Initialization Table Entries is accumulated 
as part of the ABIOS initialization process. This field must con- 
tain the number of Initialization Table Entries required by the 
ABIOS ROM extension. The minimum acceptable value is 1. 


absolute address range CO000h-DF800h. ABIOS extension 
ENTRY POINT FOR BUILD INITIALIZATION TABLE ROUTINE 
Entry point to routine to Build Initialization Table routine. 


ROMs are searched for over the same address range as part 
continued 


of ABIOS initialization. 


The extension ROM signature AA55h informs POST that an 
extension ROM is present. All extension ROMs must begin on a 
paragraph boundary. 


ROM LENGTH IN 512-BYTE BLOCKS 
Extension ROMs must be divided into 512-byte blocks. The 
maximum value for this field is 7Fh. 


CALL) POINT TO CBIOS INITIALIZATION ROUTINE (FAR 


If the extension ROM contains a portion that will be used to 
extend CBIOS, then the entry point to the CBIOS extension’s 
Initialization Routine must appear here. 


Note: If the extension ROM contains an ABIOS extension 
only, this field must contain a dummy Return Far in- 
struction. The dummy Return Far instruction allows 

POST to continue its ROM extension scan. 


ABIOS EXTENSION ROM SIGNATURE — BB66h 
The search for ABIOS extension ROMs is performed in 2K in- 
crements over the absolute address range COOOOh-DFFFFh as 
part of ABIOS initialization. The ABIOS Extension ROM signa- 
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Requirement 1: Create Proper Extension Header, Continued 


RAM extension file header 
The RAM extension file header is described in the table below. 


EXTENSION RAM PRESENT = AAS55h 
The value AA55h indicates that a RAM extension Is present. 


RAM EXTENSION LENGTH IN 512-BYTE BLOCKS 
Extension RAMs must be created in increments of 512-byte 
blocks. The maximum value for this field is 7Fh. 
MODEL BYTE 
SUBMODEL BYTE 
ROM REVISION LEVEL 
The model byte and submodel byte identify the system board 
with which the RAM extension is to be associated. The ROM 


Revision Level indicates the revision of system board ROM 
which the RAM extension is designed to interact. 


DEVICE ID 
The Device ID field (along with the secondary device !D below) 
identifies the ABIOS device with which the RAM extension is to 
be associated. 


NUMBER OF ENTRIES TO ADD TO INITIALIZATION TABLE 
The total number of Initialization Table Entries is accumulated 
as part of the ABIOS initialization process. The value contained 
in this field must be set to the number of Initialization Table 
Entries that will be required by this ABIOS ROM extension. The 
minimum acceptable value is 1. 


ENTRY POINT FOR BUILD INITIALIZATION TABLE ROUTINE 
Entry point to routine to Build Initialization Table routine. 


SECONDARY DEVICE ID 
When more than one physical device is associated with a De- 
vice ID, the two physical devices can be differentiated with a 
Secondary Device ID. When a unique ABIOS Service is required 
for each physical device, the two services must be differenti- 
ated via their Secondary Device ID. 


RAM EXTENSION REVISION LEVEL 
The RAM extension revision level identifies the revision level of 
the RAM extension. 


RESERVED 
(Must be initialized to zero.) 


continued 
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Requirement 1: Create Proper Extension Header, Continued 


Table of ABIOS Device IDs and Services 


The system ROM ABIOS contains one device service for each of the Device 
IDs listed in the table below. 


Device ID | Device Type/Service Device ID | Device Type/Service 


| 0ch__| ABIOS Internal Cals __|__oBh__| Pointing Device 
| Oth | Diskette | OCH | Reserved 
| 02h | Fixed Disk] OD Reserved 
| 08h | Video EH | CMOSRRAM 
Real Time Clock Timer 
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Requirement 2: Build Initialization Table Entry Routine 


Introduction 


ABIOS extensions are initialized and integrated as part of the general process 
of initializing the system ROM ABIOS. ABIOS extensions must contain a 
routine that can be called during the ABIOS initialization process to build the 
extension’s entry into the ABIOS Initialization Table. 


Example: Routine to Build Initialization Table Entry 


The example below shows how a routine to build an ABIOS extension’s entry 
into the Initialization Table could be implemented. 


Those routines associated with ABIOS extensions that modify an existing 
service must reserve a Device Block size equal to that reserved by the 
existing service plus enough bytes for the modification’s workspace. 


MY—BINIT proc far 


: Entry: ES:DI points to where to put init 
table entry(s) 


; Exit: far ret w/AL =000h (successful), 
80h (no units found), or other error and 
CX = # entries added. Other registers are 
preserved. 


assume DS:nothing, ES:nothing 
cld 

; patch CS in template 
mov fixsegl, CS 

; copy template to entry 
mov SI, offset MY-INITEMPL 
mov CX, 18h/2 

rep movs' word ptr ES: [DI], word ptr CS: [SI] 

sub di, 18h 


continued 
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Requirement 2: Build Initialization Table Entry Routine, Continued 


Example: Routine to Build Initialization Table Entry, cont’d 


At this point, 


: return w/AL = 0, cx = 


popa 
mov al, O 
mov cx, lL 
ret 
MY BINIT endp 
MY _INITEMPL label word 
dw MY DID1 
dw MY LIDCNT 
dw MY_DEVBLLEL 


dw offset MY_INITDS 


fixsegl dw ? 
dw MY _REQBLLEN 


dw (MY _FUNCCNT +4) *4 


dw MY DATAPTCNT*6 
dw 
dw 
dw 


MY DID2 
MY_REV+80H 
0, 0, 0 


* if this is a MODIFY, the Device Block 

* and Request Block reserved sizes should be calculated 

* from those of the previous service plus the sizes for 
** workspace required by the modification. 

* 

* 

* 


- Init Table Template 

* device ID 

- logical ID count 

* device block size in 

- bytes 

' ptr to init—FUNCT-—and- 
; DEVBL routine 

- CS — fill in the blank 
; default request block 
; length 

; function table size in 
; bytes 

; bytes required for 

; buffer ptrs 

; secondary Device ID 

; code level 

; reserved 
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Requirement 3: Routine to Build Device Blocks and FTT 


Introduction 


All ABIOS extensions must contain a routine to initialize an extension—specific 
Device Block and Function Transfer Table (FTT). 


How the routine is entered 


The routine to build an extension-specific Device Block and Function Transfer 
Table must be entered with DS:00h pointing to the Common Data Area 
(CDA) and DX = Logical ID, so that: 


» the double word at DS:(DX*8) points to where the Device Block is to be 
built, and 


= the double word at DS: (DX*8+4) points to where the Function Transfer 
Table is to be built. 


continued 
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Requirement 3: Routine to Build Device Blocks and FTT, Continued 


Extension type requirements 


How the routine to initialize an extension’s Device Block and Function Trans- 
fer operates depends on the type of ABIOS extension involved. 


Extension Type Initialization Routine 
ADD Service The extension’s Device Block and Function Transfer Table | 
can be initialized to any length required. 


REPLACE Service The initialization routine must zero the Common Data Area 
pointers to the older service’s Device Block and Function 
Transfer Table. 


This ensures that the operating system will not call the ABIOS 
service being replaced. 


MODIFY Service The initialization routine must: 


« Copy the existing service’s Device Block to where the ex- 
tension’s Device Block is to be built. 


» Initialize the modification’s workspace in the Device Block. 


» Patch the existing Device ID in the service’s Device Block 
to a number unrecognized by an operating system (e.g. 
OFFh) so that an operating system will not call it. 


Initializing the Device Block in this way ensures that the func- 
tions involved with the ABIOS extension: 


» Do not make use of any undefined areas within the existing 
service's Device Block. 


» Access extension-specific data only in the extension- 
specific workspace added at the end of the Device Block. 
In this way interstage state information need not be main- 
es between the extension and the pre-existing ABIOS 
service. 


* Build an extension-specific Function Transfer Table that 
takes over all three entry routines. 


continued 
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Requirement 3: Routine to Build Device Block and FTT, Continued 


Pseudocode: Routine to Build Device Block and Function Transfer Table 
for a Fixed Disk Service REPLACEment 


MY_INITDS proc far 

: Entry: CX = logical ID count 

: DX lst logical ID 

; DS:0 points to CDA 

: Exit: FAR RET w/: AL = error code (0) 
2 for each LID up until mine, 

* if it’s for my device (DIDS & DID2S are =), 
* if device block rev > mine, 

* go zero my LID’sS ptrs and abort 

* endif 

* zero that LID’s ptrs 

* endif 

* next LID 

+ init device block(s) { 

* copy DB template 

* init device unique data 

* init all unit unique data { 

> for each UUDA, 
* 
x 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


’ 


e 


’ 


3 


’ 


$ 


e 


5] 


e 


’ 


’ 
° 
° 
9 


; get drive # 

get potential hard disk params 
get drive type, params for type 
call UUDInit 


next UUDA 


° 
i 
e 
e 
’ 


: fill in offset to first data pointer 
fill in LID 
calc & fill in dev block size 
} 

build function transfer table 

exit 


9 


$ 


e 


’ 


INITDS endp 
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Requirement 4: ABIOS Service Code 


Introduction 


Each ABIOS extension must contain the code implementing all or part of an 
ABIOS device service. This is the run-time code of an extension; the other 
requirements deal only with ABIOS initialization. 


Reference 


Information under the Examples heading in this chapter provides concrete 
examples of how various kinds of extensions can be coded. 


Initialization: ABIOS ROM Extensions 


Introduction 


The process of initializing an ABIOS ROM extension includes the same steps 
and is closely integrated with the process of initializing the system board 
ROM ABIOS. 


Limits of this discussion 


The discussion below is limited to only those areas of ABIOS initialization 
directly related to the initialization of ABIOS ROM extensions. For additional 
ABIOS initialization information, refer to Chapter 4. 


continued 
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Initialization: ABIOS ROM Extensions, Continued 


ROM extension initialization procedure 
The table below lists the steps involved in initializing ABIOS ROM extensions. 


rset 
The operating system calls CBIOS INT 15h, AH = 04h Build System Pa- 
rameters Table. 


The Build System Parameters Table function scans (in 2K increments) 
absolute addresses C0000h to DFFFFh, testing for a valid ABIOS ROM 
extension header. Valid ABIOS ROM headers contain a signature value 
of BB66h at offset 06h. 


When a valid ABIOS ROM extension is found, the Build System 
Parameters Table function: 


« Reads the Number of Initialization Table Entries at ROM extension 
header offset 08h. 


=» Adds that value to the value in offset 1Eh of the System Parameters 
Table. 


Continues it search at the next 2K boundary. 


aie operating system call CBIOS INT 15h, AH = 05h Build Initialization 
Table. 


5. The Build Initialization Table function scans (in 2K increments) absolute 
ue C0000h to DFFFFh, testing for a valid ABIOS ROM extension 
header. 


Valid ABIOS ROM headers contain a signature value of BB66h at offset 
06h. When a valid ABIOS ROM extension is found, the Build Initialization 
Table function performs a far call to offset 09h in the ROM extension 
era This is the ROM extension’s routine to Build Initialization Table 
ntry. 


Once it has built its entry into the Initialization Table, the ABIOS ROM 
extension’s Routine to Build the extension’s Device Block and Function 
Transfer Table are called directly from OS/2 in the same manner as 

system board ABIOS device code. 


The routine to build the extension’s Device Block and Function Transfer 
Table may choose to install or not install itself. If it does not install it- 
self, it zeros its Device Block pointer and Function Transfer Table 
pointer in the Common Data Area. 
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Initialization: ABIOS RAM Extensions 


Introduction 


The process of initializing an ABIOS RAM extension is similar to the process 
of initializing an ABIOS ROM extension. 


The difference between the two lies in the additional steps that the Build 
Initialization Table routine contained ABIOS RAM extensions must take to 
insure that only the latest revision of a given ABIOS service is initialized. 


When RAM extensions are initialized 


ABIOS RAM extensions are initialized only after the system board ROM ABIOS 
and all adapter board ABIOS ROM extensions have been fully initialized. 


Extension requirements reprised 


As discussed in the previous pages, all ABIOS RAM extensions must meet 
the four requirements below: 


=» Requirement 1: ROM Extension Header 
» Requirement 2: Build Initialization Table Routine 


~= Requirement 3: Routine to Build Device Block and Function Transfer Table 
» Requirement 4: Extension Code 


Limits of this discussion 


The discussion below is limited to those areas of ABIOS initialization directly 
related to the initialization of ABIOS RAM extensions. For further information 
about ABIOS initialization, refer to Chapter 4. 


continued 
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Initialization: ABIOS RAM Extensions, Continued 


RAM extension initialization procedure 
The table below lists the steps involved in initializing ABIOS RAM extensions. 


The operating system calls CBIOS INT 15h, AH = 04h Build System 
Parameters Table. 


The Build System Parameters Table function scans RAM extension area, 
polling the Number of Initialization Table Entries field (offset 08h) of each 
RAM extension header to determine the total number of Initialization Table 
Entries. 


When a valid ABIOS RAM extension is found, the Build System Parame- 
ters Table function: 


» Reads the Number of Initialization Table Entries at RAM extension 
header offset 08h. 


« Adds that value to the value in offset 1Eh of the System Parameters 
Table. 


Continues it search at the next 2K boundary. 


Once it has built its entry Into the Initialization Table, the ABIOS ROM 
extension’s Routine to Build the extension’s Device Block and Function 
Transfer Table are called directly from OS/2 in the same manner as 

system board ABIOS device code. 


If the extension replaces or modifies an existing service, the Routine to 
Build DB and FTT may compare the extension’s revision level against the 
revision level of the existing service, choosing to replace or modify only if 
its own revision is greater. To disable either the existing service or the 
extension’s service, the corresponding DB and FTT pointers in the CDA 
must be zeroed. 


Reference 


To be initialized, all ABIOS RAM extensions should be listed in the OS/2 file 
ABIOS.SYS. For more information on ABIOS.SYS, refer to the documentation 
accompanying OS/2. 


continued 
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Initialization: ABIOS RAM Extensions, Continued 


The ABIOS RAM extension area 


The ABIOS RAM extension area resides in system RAM and contains a 
chained list of all ABIOS RAM extensions. The ABIOS RAM extension area 
must start on a paragraph boundary. Individual RAM extensions within the 
ABIOS RAM extension area are linked via the Extension Length in 512-Byte 
Blocks field in the RAM Extension header. 


Considerations for last RAM extension in area 


The last RAM extension in the ABIOS RAM extension area must have its 
Extension Length in 512-Byte Blocks header field set to zero. 


Examples of How to Modify an Existing Service 


Introduction 


Anything a programmer might hope to achieve with ABIOS extensions that 
MODIFY an existing service can be achieved by building extensions that do 
not replace individual function-start vectors. 


Well-behaved programming strategies that are useful in different situations 
include: 

=» Non-intrusive service interception 

» Redirection of a nonstaged function 

» Redirection of a staged function 
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Example 1: Non-Intrusive Interception 


Description 


The example below shows how an ABIOS extension can replace an entire 
service yet redirect all activity to the previous device service transparently to 
that service and to the operating system. 


Code example: non-intrusive interception 


CODE segment byte public 
assume cs:CODE 


Start: 
‘ RAM extension header 
dw OAA55h 
db EXTSIZE 
db O, O, O 
dw 2 
db 1 


jmp near ptr BINIT 
db OFFh, OFFh 
dw oO 


length in half Ks 

model, submodel, ROM revision 
device ID for hard disk 

# initialization table entries 
build init table entry 
secondary dev ID, my revision 
reserved 


; my workspace in pseudo—Device-Block: 


' offsets into workspace: 


WORK1 equ 0 
WORK3 equ 2 
WORKSPACESIZE equ 3 
OLDFUNCTOFF dw ? 

FUNCT 

MYDATAPTROFF dw ? 

WORKSPACEOFFSET dw ? 

workspace 


FUNCTABLESIZE dw ? 


ABIOS Extensions 


- word 


byte 
my read-only (after init) data: 
offset in CDA of ptr to old LIDs 


offset in CDA of my data ptr 
offset in device block of my 


Size of previous function table 


continued 
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Example 1: Non-Intrusive Interception, Continued 


Code example: non-intrusive interception, cont’d 


BINIT proc far; Build-initialization table subroutine 
-* find previous init table for this device ID 

if none, go return unhappy 

store DID, LID count=1 

WORKSPACEOFFSET = previous device block size 

store device block size = previous device block size + 
WORKSPACESIZE 

store pointer to init-data-structures subroutine 

store request block size = previous request block size 
store function table size = 4*4 

store data pointer size, DID2, revision, 0000s 

>* return happy 

BINIT endp 


* * *%* * %&¥ * & & & 


INITDS proc far ; Initialize-data-structures subroutine 
;* get offset of our pointers in CDA 

find previous service’s ptrs in CDA 

save offset to its function table 

copy device block to mine, changing size 

init workspace at end of device block 

give old driver a weird device ID so OS doesn’t call it 
build function transfer table — vectors to 

LOGSTART, LOGINTERRUPT, 

and LOG Time-out routines (and no functions) 

update Common Data Area’s data pointer count 

find where my data pointer goes 

load my data pointer 

MYDATAPTROFF = offset of my data pointer’s selector in CDA 
** return happy 

INITDS endp 


* * * &€ &€ &€ FE EF KF KF KF FX 


we 


continued 
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Example 1: Non-intrusive Interception, Continued 


Code example: non-intrusive interception, cont’d 


LOGTime-out: * time-out routine 
;* save offset into transfer table 8 

** goto LOGCOMMON 

LOGINTERRUPT: - interrupt routine 
;* save offset into transfer table 4 

;* goto LOGCOMMON 

LOGSTART: ' start routine 

** save offset into transfer table 0 

;* goto LOGCOMMON 


LOGCOMMON proc far 

-* save registers 

;* change function transfer table in stack for revector 

get address of previous service’s start, int, or time-out 
routine from previous transfer table 

place it in stack for return from here 

get function code from request block 

get pointer to workspace 

get my data pointer 

record function code 

restore registers and return (to previous service’s start 
;* routine) 

LOGCOMMON endp 


we we we we we we we 


* * %& *& & & & * 


we 


EXTSIZE = (offset $ — offset start + 1FFh)/200h 
;* RAM ext. size / 200h 
org EXTSIZE*200h 


CODE ends 
end 
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Example 2: Redirection of a Nonstaged Function 


Description 


Redirection of a nonstaged function is relatively easy. The extension’s start 
routine examines the function code in the request block and either services 
the function itself or redirects the request to the previous device service. 


In the example below, a replacement video service redirects all functions to 
the previous video service and regains control when that service returns. It 
then checks to see if one of the font-loading functions was performed; if so, 
the font is “italicized” by shifting half of each loaded character font. 


Code example: redirecting a nonstaged function — italicizing fonts 


INITDS proc far ; Initialize-data-structures subroutine 
-* get offset of our pointers in CDA 

;* find previous service’s ptrs in CDA 

save offset to its function table 

copy device block to mine 

give old driver a weird device ID so OS doesn’t call it 
build function transfer table — vector to MYSTART (and no 
functions) 

update Common Data Area’s data pointer count 

find where my data pointer goes 

load my data pointer 

MYDATAPTROFF = offset of my data pointer’s selector in CDA 
;* return happy 

INITDS endp 


* %* & & &F & & KF 


- continued 
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Example 2: Redirection of a Nonstaged Function, Continued 


Code example: redirecting a nonstaged function — italicizing fonts, cont'd 


MYSTART proc far 
-* Save registers. 
-* Build additional stack, copying pointers from passed stack, 
replacing transfer table vector with vector to previous 
transfer table. 
Get previous service start address from previous transfer 
table. 
Call previous service start routine. 
Flush additional stack. 
Get function code from request block. 
if function code = OFh or 10h, 

set up hardware to access font plane, 

get my data pointer (to font at AOO00O) 

for each character, 

shift top half of character definition right. 

next character 

restore hardware 
ae endif 
-* restore registers and return to OS 
MYSTART endp 


- start routine 


* * * * *€* * & & ¥ HK KF KR KH KF F 
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Example 3: Redirection of a Staged Function 


Description 


186 


Replacing a staged function requires careful design because all stages of the 
interrupt function must be redirected, not just the function start. 


The way to handle this is for all three device service entries — the start 
routine, the interrupt routine, and the time-out routine — to make redirection 
decisions based on function code. 


For instance, if an extension wishes to replace only “read” functionality, all 

three entries into the device service (start, interrupt, and time-out routines) 
will examine the function code in the request block and redirect all functions 
except “read” to the corresponding entry in the previous device service. 


In this manner, interstage state information (which is private) need not be 
compatible between, say, an extension’s start processing and the system 
ROM ABIOS’s interrupt processing. 


In the example on the following page, an ABIOS extension for a diskette 
drive which has a “ready” signal rather than a change line is presented. 


continued 
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Example 3: Redirection of a Staged Function, Continued 


Code example: redirecting staged functions — diskette change line emulation 


INITDS proc far ; Initialize-data-structures subroutine 
-* get offset of our pointers in CDA 

-* find previous service’s ptrs in CDA 

save offset to its function table 

copy device block to mine, changing size 

init workspace at end of device block 

give old driver a weird device ID so OS doesn’t call it 
build function transfer table — vectors to MYSTART, 
MYINTERRUPT, 

and previous service’s time-out routine (and no functions) 
update Common Data Area’s data pointer count 

find where my data pointer goes 

load my data pointer 

MYDATAPTROFF = offset of my data pointer’s selector in CDA 
°* return happy 

INITDS endp 


* * *€* &€ & & € KF KF KF 


MYINTERRUPT proc far  ; interrupt routine 
;* save registers 
if it’s diskette interrupt but function code = 0000 
(default), 
sense interrupt status 
if interrupt is due to change in state of ready line, 
changedflag = yes 
endif 
restore regs and return to caller w/ return code 0000 
endif 
get address of previous service’s interrupt routine 
place it in stack for return from here 
restore registers and return (to previous service’s 
: interrupt routine) 
MYINTERRUPT endp 


* * &€* & KF € KF KF KF KF KR OF 


we 


continued 
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Example 3: Redirection of a Staged Function, Continued 


Code example: redirecting staged functions — diskette change line emulation, 
cont'd _ 


MYSTART proc far ; start routine 
-* save registers 
-* get function code from request block 
. ok if function code = OOOE, 
if changedflag = yes, 
restore regs and return to caller w/ change active 
else if changedflag = no, | | 
restore regs and return to caller w/ change inactive 
endif 
else if function code = 0008 through OOOB, 
if changedflag = yes, 
sense drive status 
if drive not ready, 
restore regs and return to caller 
(w/ return code 8s00D) 
else, 
restore regs and return to caller 
(w/ return code 8006) 
changedflag = no 
endif 
endif 
endif 
change function transfer table in stack for revector 
get address of previous service’s start routine 
place it in stack for return from here 
restore registers and return 
* (to previous service’s start routine) 
MYSTART endp 


* * * €* * * €F FF HK EF FE KF KF KF KF KF KF KF KF KF KF XK 
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Chapter 8 
ABIOS Diskette Service 


Overview 


Introduction 
The ABIOS Diskette Service provides access to diskette I/O operations. 


Rules for using the PS/2 BIOS Diskette Services 


Because the CBIOS and ABIOS interface with different operating systems, 
either the CBIOS or ABIOS Diskette Service may place diskette hardware in 
an unknown state. The CBIOS does not inform the ABIOS of the diskette 
hardware state when control is passed from the CBIOS to the ABIOS, and 
vice versa. As a result, it is possible for one part of the PS/2 ROM BIOS to 
put the diskette hardware in a state that will not be recognized by the other 
part of the BIOS. 


continued 
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Overview, Continued 


Rules for using the PS/2 BIOS Diskette Services, cont'd 

Follow the rules listed below to avoid diskette problems in the PS/2 BIOS: 

1. If there is an outstanding ABIOS Diskette function request, do not request 
a CBIOS diskette function. 

2. If there is an outstanding CBIOS Diskette function request, do not request 
an ABIOS Diskette function request. 

3. If using CBIOS and the last Diskette Service function call was to ABIOS, 
request INT 13h, AH = 00h, Reset Diskette System, before invoking other 
CBIOS Diskette functions. 

4. lf using ABIOS and the last Diskette Service function call was to CBIOS, 
request ABIOS Diskette Service function 05h, Reset Diskette System, 
before invoking other ABIOS Diskette Service functions. 

5. After ABIOS is initialized, the first ABIOS Diskette Service function request 
must be function 05h, Reset Diskette System. 


Logical IDs for diskette drives 


All diskette drives may share the same Logical ID with each drive assigned a 
separate unit number. For example, all diskette drives may be Logical ID 11. 
Diskette drive 0 may be Logical ID 11, Unit 0 and diskette drive 1 may be 
Logical ID 11, Unit 1. 


continued 
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Overview, Continued 


Diskette Change Line signal 


Some diskette drives are equipped with a Diskette Change Line signal that is 
set when the diskette drive door is opened. The Diskette Change Line signal 
has two states, set and not set: 


= set 
The diskette has been changed or the diskette drive door is open. Disk- 
ette data cannot be read or written in this state. Diskette media status 
cannot be determined while the Change Line is set. 


= not set 
The diskette drive door is closed, information can be read from and 


written to the diskette, and all status information can be read and 
modified. 


Testing the Diskette Change Line signal status 


The Diskette Change Line signal status is tested by the ABIOS Diskette 
Service before functions 08h Read Diskette, 09h Write to Diskette, OAh 
Format Diskette, or OBh Verify Diskette Data are processed. 


Function 03h Read Device Parameters may be requested to determine if 
the Diskette Change Line signal status is supported by the specified dis- 
Kette drive. 


continued 
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Overview, Continued 


Summary of Diskette Service functions 


ee 
SS 0 
[0s | Feed Device Parameters 
[oan | “Set Device Parameters 
[osm | Resettiaze Disette Sabet 
a 
[om | oiabie oikete 
a 
[00m | wrte odes SSS 
oan 
[08 
een 
tn 
ee 
ee 
to 


In this chapter 
This chapter includes information about the following topics: 
=» Hardware Environment 
» Error Handling 
» ABIOS Diskette Service functions 
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Hardware Environment 


Hardware interrupt 


The ABIOS Diskette Service is associated with hardware interrupt request 6 
(IRQ 6). 


Diskette controller 


The ABIOS supports an NEC 765 or equivalent diskette controller. Also, 
additional hardware support for data separation, interrupt, and DMA control 
is required. 


Data transfer rates 


All supported formats must use a 512-byte sector size. Data transfer rates 
supported are: 


Transfer Rate Diskette 
(Kbs)* Capacity | Drive Capacity Drive Size 


* Kilobits per second 


continued 
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Hardware Environment, Continued 


Supported drive types 


The ABIOS supports a maximum of two diskette drives. The Phoenix ABIOS 
supports both 5.25 inch and 3.5 inch diskette drives. The IBM ABIOS sup- 
ports only 3.5 inch diskette drives. 


The Phoenix ABIOS Diskette Service supports four types of diskette drives: 


Maximum 
Storage Capacity 


5.25 inch diskette compatibility 


5.25 inch diskette media can be high density (1.2 MB) or double density 

(360K). Diskettes written to on one type of 5.25 inch drive may or may not 
be written to or read from using the other type. The following table outlines 
the possible read/write combinations of 5.25 inch diskette media and drive 


types. 
And it can be 
written to by... 


If diskette was | Then it canbe | 
Media Type | formatted on... | read on... 
360K 360K drive 360K drives | 1.2 MB drives 360K drives only 
360K drive 360K drives | 1.2 MB drives | 360K drives only 


If a high density (1.2 MB) diskette is formatted on a 1.2 MB drive, it can 
only be read from and written to by 1.2 MB drives. 


The DOS command, format/4, can be used to format a 360K diskette in a 
1.2 MB drive. Both 1.2 MB and 360K drives can generally read and write 
these diskettes. 


continued 
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Hardware Environment, Continued 


3.5 inch diskette compatibility 


The following outlines the possible read/write combinations for 3.5 inch 

drives and media: 

=» If a 720K media type diskette is formatted on a 720K drive, it can be read 
on either 720K or 1.44 MB drives, but it can only be written to by 720K 
drives. 

= If a 1.44 MB media type diskette is formatted on a 1.44 MB drive, it can 
only be read from and written to by 1.44 MB drives. 


Error Handling 


How errors are reported 


ABIOS signals the status (Successful. Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


lf Bit 15 of the Return Code field is set, the diskette function requested has 
an error. The caller’s Return Code handler routine should test Bits 14, 13, 
12, and 8 to determine the class of error that has occurred, and should then 
test the remaining bits to determine the precise nature of the error. 


Retryable diskette errors 


When Bit 8 (Retryable Error) of the Return Code is set, the request should 
be retried. The recommended number of retries is returned by Diskette 
function 03h, Read Device Parameters (in offset 2Bh in the Request Block). 
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Function: 00h — Default Interrupt Handler 


Description 


Function 00h, Default Interrupt Handler, is a single-staged request. It handles 
unexpected hardware interrupts by resetting the interrupt at the device level. 


How function is requested 


When the Logical ID associated with the ABIOS Diskette Service has no 
outstanding Request Blocks waiting for an interrupt and an unexpected hard- 
ware interrupt Occurs, the operating system must build a Request Block in> 
the format below and call function OOh to turn off the interrupt at the diskette 
controller level. | | 


Request Block Structure 


Lottset| size || impute ff Outputs 
Word , 
2 
Word 5 | 


__ och | Word 
na a FRC CR ICE RRR CR RRR CR IURRCLCIGER as OER EES SS 


IETS EY AES ST SS ESE SS PO SET EP CF ET TES I TE EY gE, ES 5 CT SS DE ESE ET ES AT LES ESE CIEE 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


| 0005h | Not My Interrupt, Resume Stage after Interrupt 
| coosh | Invalid Unit Number 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns the parameters for the 
Diskette Logical ID. 


Request Block Structure 


Logical ID Flags 


Bits 15-4 = Reserved 
Bit 3 = 0 No overlap across 
units 

Bit 2 = 0 Reserved 

Bits 1-O = Transfer Data Pointer . 
Mode: 
10b = Physical Pointer 

Required 


: Request Block Length (for other | 
. “|| functions) 
_Reserved (initialize to 0000h) Secondary Device ID 


3 Revision Level 


: eee 2221) Diskette Controller Status Byte 


continued 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Code 
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Function: 03h — Read Device Parameters 


Description 


This function is a single-staged request. It returns the parameters for this 
device in the Request Block as specified below. The information returned 
applies to the maximum capacity of the media for the specified drive type. 
The ABIOS resets the diskette subsystem if there is a hardware error. 


Request Block Structure 


il 


Word Request Block Length | 
Logical ID 1] 
| 06h | Word || Function (0003h : 
Reserved (initialize to 0000h | | 
Reserved (initialize to 0000h) 
Mec ece eee ee eet tee eae ltl ale letalelalelelelelelelelelele slaleletalelel Talelel | ReturnCode —is 
OEh '||_Time-out Value 
10h Word ‘|| Sectors per track for the maximum 
media density supported by the 
| drive 
12h Word Sector Size in bytes 
00h = Reserved 
Oth = 256 bytes/sector 
02h = §12 bytes/sector 
| (Default) 
14h Word Device Control Flags 


Bits 15-4 = Reserved 
Bit 3 = Recalibrate status 
0 Recalibrate not 
required 
1 Recalibrate required 
Bit 2 = Concurrent operations 
0 Not supported 
1 Supported 
Bit 1 = Format unit information 
0 Not supported 
1 Supported 
Bit O = Change signal 
availability 
0 Not available 
1 Available 


continued 
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Function: 03h — Read Device Parameters, Continued. 


Request Block Structure, cont’d 


Diskette Drive Type 


= Drive not present/invalid 
CMOS RAM . 

= §.25 inch 40-Track, 2—Head, 
360K 


= Reserved 

= Reserved 

= 3.5 inch, 80-Track, 2—Head, 
1.44MB | 


Reserved 


Delay Before Turning Motor Off | 
(microseconds) 


Motor Startup Time (microseconds) 


Word , Number of Cylinders on the 
Maximum-Density Media the Drive 
: Supports 


Number of Heads 


Data Length 


=1| Disk Controller Status Byte 


continued 
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Function: 03h — Read Device Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


CO003h Invalid Unit Number 
C004h Invalid Request Block Length 


FFFFh Return Code Field Not Valid 
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Function: 04h — Set Device Parameters 


Description 


This function is a single-staged request. It is used to change the default 
Sector Size (512 bytes), Gap Length, and Data Length for diskette |/O 
functions. 


If a diskette is formatted with a sector size other than 512 bytes, this func- 
tion must be issued before executing functions 08h Read Diskette, OSh Write 
to Diskette, OAh Format Diskette, or OBh Verify Diskette Data. 


The ABIOS resets the diskette subsystem if there is a hardware error. 


Request Block Structure 


| 06h | Word | 
| 08h_| Word _| 

OAh 
Word 
= of sector (bytes) 


OOh = Reserved 
Oih = 256 bytes per sector 
02h = 512 bytes per sector 


Gap Length for Read/Write/Verify 
33h Data Length : _ 


continued 
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Function: 04h — Set Device Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


C004h Invalid Request Block Length 
C005h Invalid Sector Size _ 


FFFFh Return Code Field Not Valid 


Function: 05h — Reset/Initialize Diskette Subsystem 


Description 


This function is a discrete multistaged request. It resets the diskette control- 
ler to a Known state, which generates an interrupt to which the caller must 
respond and forces a recalibration of the diskette drive(s) on the next ac- 
cess to each drive. The ABIOS resets the diskette subsystem if there is a 
hardware error. 


If using both ABIOS and CBIOS Diskette Services 


lf a CBIOS Diskette Service function has been requested last, the caller must 
request ABIOS Diskette function 05h before requesting any other Diskette 
function. 


If ABIOS has just been initialized, the caller must request this function to set 
the diskette subsystem to a known state. 


continued 
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Function: 05h — Reset/Initialize Diskette Subsystem, Continued 


Testing the Diskette Change Line signal status 


The Diskette Change Line signal status is tested by the ABIOS Diskette 
Service before functions 08h Read Diskette, 09h Write to Diskette, OAh 
Format Diskette, or OBh Verify Diskette Data are processed. 


Function 03h Read Device Parameters may be requested to determine if the 
Diskette Change Line signal status is supported by the specified diskette 
drive. 


Diskette Change Line signal 
The Diskette Change Line signal has two states: set and not set. 


a Set | 
The diskette has been changed or the diskette drive door is open. Disk- 
ette data cannot be read or written in this state. Diskette media status 
cannot be determined while the Change Line is set. 


= Not set 
The diskette drive door is closed, information can be read from and 
written to the diskette, and all status information can be read and 
modified. 


Turning off the diskette motor 


If it is Known that the requested function is the last diskette operation and 
the Return Code is 0000h Successful Operation, the caller can turn off the 
diskette motor by requesting function OFh, Turn Diskette Motor Off. The 
recommended turn-off delay value can be found by requesting function O3h, 
Read Device Parameters. 


Track switching 


The ABIOS Diskette Service does not support a switch from head 1 of a 
diskette cylinder to head O of the next cylinder. However, it allows you to 
cross track boundaries if you switch from head 0 to head 1 on the same 
cylinder. | 


continued 
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Function: 05h — Reset/initialize Diskette Subsystem, Continued 


Switching between ABIOS and CBIOS 


Request this function after switching from CBIOS to ABIOS and before invok- 
ing any other ABIOS Diskette Service functions. 


Request Block Structure 


Cr 


| 00h | Word _ 
oan Word 
6h | Word 
Toh | Word 
: one L 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


a 
B000h 


FFFFh Return Code Field Not Valid 
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Function: 06h — Reserved 


Function: 07h — Disable Diskette 


Description 


This function is a single-staged request that disables the diskette interrupt. 
ABIOS reads the diskette controller result bytes and returns them at offsets 
3Ah and 3Bh in the Request Block and then shuts down the diskette inter- 

rupt. The ABIOS resets the diskette subsystem if there is a hardware error. 


Request Block Structure 


| 00h | Word || Request Block Length || 
| 02h | Word | Logical ID 
| 04h | Word jf unit 
| 06h_ | Word |] Function (0007h) 


| OEh | Word | 


10h | Word Reserved | Reserved (Initialize to 0000h) to 0000h) ES 


Word Ro EE 11 Diskette Result Byte 0 (Status Regis- 
|| ter 0), where: 
Bits 7-6 = Interrupt Code 
0O0b = Command ends 
normally 
01ib = Commands ends | 
abnormally | 
10b = Invalid command 
11b = Ready Line state 
changed 
Bit 5 1 Seek End 
Bit 4 1 Equipment Check 
Bit 3 1 Not Ready | 
Bit 2 1 Head Address 
Bit 1 1 Unit 1 selected 
Bit 0 = 1 Unit 0 selected 


Word Diskette Result Byte 1 (Present Cyl- 
-[[ Inder Number) _ | | 


continued 
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Function: 07h — Disable Diskette, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0000h Successful Operation 
| 000th Resume Stage after Interrupt 
8000h Device Busy, Request Refused 


9009h Controller Failure in Reset Operation 
| 9120h All Diskette Controller Register Bytes Not Read 


9180h Either Data is Not Ready Or the Transfer Direction 
is Incorrect 
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Function: 08h — Read Diskette 


Description 


This function is a discrete multistaged request that reads data from the. 
specified cylinder, head, and sector number on the specified diskette drive 
to the memory location specified in Data Pointer 2, if the Diskette Change 
Line signal status is not set (the diskette door is closed). 


lf a diskette is formatted with a sector size other than 512 bytes, function 
04h Set Device Parameters must be issued, resetting the sector size, before 
executing this function. 


The ABIOS resets the diskette subsystem if there is a hardware error. 


Turning off the diskette motor 


lf it is Known that the requested function is the last diskette operation and 
the Return Code is 0000h Successful Operation, the caller can turn off the 
diskette motor by requesting function OFh, Turn Diskette Motor Off. The 
recommended turn-off delay value can be found by requesting function 03h, 
Read Device Parameters. 


Track switching 


The ABIOS Diskette Service does not support a switch from head 1 of a 
diskette cylinder to head O of the next cylinder. However, it allows you to 
cross track boundaries if you switch from head 0 to head 1 on the same 
cylinder. 


continued 
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Function: 08h — Read Diskette, Continued 


Request Block Structure 


, 
[06h | Word | : 
[oan | Word _| 
: 


[12h | DWord |] Reserved 
| 16h 
18h 


Reserved (Initialize to 0000h) 
18h Reserved (lInitlalize to 0000h) 


Data pointer 2 (32-bit physical : 
address required) : 


| Time to wait before continuing 
request (microseconds) — Valid 
only if Return Code is 0002h. 


[26h Word || Cylinder number (0-based) || 
| 2Ah | Byte || Head number (O-based) |} 


continued 
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Function: 08h — Read Diskette, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 


0000h Successful Operation 


If the Number of Sectors to Read field is zero, 
no action is performed and this Code is generated. 


| 000th Resume Stage after Interrupt 
: 0002h Resume Stage after Time Delay 


Media Changed | 

Generated if the ABIOS can reset the Diskette . 

Change Line signal to not set; data may be transmitted. 
Media Not Present 

Generated if the ABIOS cannot reset the Diskette 

Change Line signal to not set; no data is transferred. 
[et02n | Aderose Mark Not Found 
[ation [Bad CRC on Diskette Read SCSCSC~*d 
[er20n | Controler Faure SSS 
[e14on | Seek Operation Faled SSCS 
Return Code Field Not Valid | 
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Function: 09h — Write to Diskette 


Description 


This function is a discrete multistaged request that writes the specified 
number of sectors of data from the memory location specified by Data 
Pointer 2 to the specified cylinder, head, and sector number on the specified 
diskette drive if the diskette Change Line signal status is not set (the disk- 
ette door is closed). 


lf a diskette used in the system’s diskette drive(s) was formatted with a 
sector size other than 512 bytes, function 04h Set Device Parameters must 
be issued, resetting the sector size, before executing function 09h Write to 
Diskette. 


The ABIOS resets the diskette subsystem if there is a hardware error. 


Turning off the diskette motor 


If it is Known that the requested function is the last diskette operation for 
awhile and the Return Code is 0000h Successful Operation, the caller can 
turn off the diskette motor by requesting function OFh, Turn Diskette Motor 
Off. The recommended turn-off delay value can be found by requesting 
function 03h, Read Device Parameters. 


Track switching 


The ABIOS Diskette Service does not support a switch from head 1 of a 
diskette cylinder to head O of the next cylinder. However, it allows you to 
cross track boundaries if you switch from head 0 to head 1 on the same 
cylinder. 


continued 
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Function: 09h — Write to Diskette, Continued 


Request Block Structure 


Teves] sue [moe doe 


: 
: 
Word 
Word 
Word : 


Time to wait before continuing 
request (microseconds) — Valid 
only if Return Code is 0002h. 


34h 
2An_| Byte 


continued 
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Function: 09h — Write to Diskette, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Code Description 


0000h 


Successful Operation 


If the Number of Sectors to Read field is zero, 
no action is performed and this Code is generated. 


Resume Stage after Interrupt 


0002h 
8000h 
8003h 
8006h 


Resume Stage after Time Delay 


Device Busy, Request Refused 


Write Attempted on Write-Protected Diskette 


Media Changed 


Generated if the ABIOS can reset the Diskette 
Change Line signal to not set; data may be transmitted. 


800Dh Media Not Present 


Generated if the ABIOS cannot reset the Diskette 
Change Line signal to not set; no data is transferred. 


| 9009h Controller Failure in Reset Operation 
9102h Address Mark Not Found 
9104h Requested Sector Not Found 
9108h 


DMA Overrun on Operation 
| Bad CRC on Diskette Read 


9120h Controller Failure 


Seek Operation Failed 
9180h | 
C000h 
Cooth Invalid Function 

Co003h Invalid Unit 

C004h | Invalid Request Block Length 
Co00Ch 
FFFFh 


Error 


Invalid Logical ID 


Unsupported Media Type/Unestablished Media 
Return Code Field Not Valid 
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Function: 0Ah — Format Diskette 


Description 


This function is a discrete multistaged request that formats the media in the 
specified drive if the Diskette Change Line signal status is not set (the disk- 
ette drive door is closed). 


If a diskette is formatted with a sector size other than 512 bytes, function 
04h Set Device Parameters must be issued, resetting the sector size, before 
executing function OAh Format Diskette. 


The ABIOS resets the diskette subsystem if there is a hardware error. 


Formatting a diskette 
To format a diskette: 


1. Construct a table with one entry (the Address field) for each sector on 
the track. The table entries (Address fields) must have the format de- 
scribed below. 


2. Place the table in a buffer and place the address of the buffer in Data 
Pointer 2. 


3. Request function ODh Set Media Type for Format. The field ID for each 
sector is written sequentially from the buffer to each sector in the 
specified track. 


Address field format 
Each Address field consists of the following four bytes, in order: 


=» Track number (C) 
=» Head number (H) 
= Sector number (R) 
=» Sector size (N) 


Each sector on the track must be represented by one entry, consisting of 
one byte each containing the data items above, in order, in the buffer 
pointed to by Data Pointer 2. 


continued 
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Function: 0Ah — Format Diskette, Continued 


Return Code Processing 


lf the Return Code is 8006h Media Changed or 800Dh Media Not Present, 
request function ODh Set Media Type for Format before invoking function OAh 
Format Diskette again. 


Turning off the diskette motor 


If it is Known that the requested function is the last diskette operation and 
the Return Code is 0000h Successful Operation, the caller can turn off the 
diskette motor by requesting function OFh, Turn Diskette Motor Off. The 
recommended turn-off delay value can be found by requesting function O3h, 
Read Device Parameters. 


Track switching 


The ABIOS Diskette Service does not support a switch from head 1 of a 
diskette cylinder to head O of the next cylinder. However, it allows you to 
cross track boundaries if you switch from head 0 to head 1 on the same 
cylinder. 


continued 
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Function: 0Ah — Format Diskette, Continued 


Request Block Structure 


Word .. : 
: 
. | 

ord 


| Reserved (Initialize to 0000h) 
Data pointer 2 (32-bit physical) 
| 1Eh | Word || Reserved (Initialize to 0000h) : 


DWord 


Time to wait before continuing 
request (microseconds). Valid only 
if Return Code is 0002h. 


W 
| 24h | Word | Subfunction number 
| 26h | Word || Cylinder number (0-based) 
Head number (0-based) : 


continued 
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Function: 0Ah — Format Diskette, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Code Description 


0000h 


Successful Operation 


If the Number of Sectors to Read field is zero, 
no action is performed and this Code is generated. 


8006h Media Changed 


Generated if the ABIOS can reset the Diskette 
Change Line signal to not set; data may be transmitted. 


Media Not Present 


Generated if the ABIOS cannot reset the Diskette 
Change Line signal to not set; no data is transferred. 


9104h 


FFFFh Return Code Field Not Valid 


800Dh 
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Function: 0Bh — Verify Diskette Sectors 


Description 


This function is a discrete multistaged request that verifies the data residing 
on the specified number of sectors on the specified cylinder number, head 
number, and sector number on the drive if the the diskette drive door is 
closed. The data is not read, but is determined to be accurate. 


If a diskette used in the system’s diskette drive(s) was formatted with a 
sector size other than 512 bytes, function 04h Set Device Parameters must 
be issued, resetting the sector size, before executing this function. 


The ABIOS resets the diskette subsystem if there is a hardware error. 


Turning off the diskette motor 


If it is Known that the requested function is the last diskette operation and 
the Return Code is 0000h Successful Operation, the caller can turn off the 
diskette motor by requesting function OFh, Turn Diskette Motor Off. The 
recommended turn-off delay value can be found by requesting function 03h, 
Read Device Parameters. | 


Track switching 


The ABIOS Diskette Service does not support a switch from head 1 of a 
diskette cylinder to head O of the next cylinder. However, this service will 
allow you to cross track boundaries if you switch from head 0 to head 1 on 
the same cylinder. 


continued 
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Function: OBh — Verify Diskette Sectors, Continued 


Request Block Structure 


| 04h | Word | 
| 06h | Word || Function (000Bh 
| 08h | Word |] Reserved (initialize to 0000h 


Reserved (Initialize to 0000h) o ie es 


DWord os Bia pee teet eer ae 


20h 


continued 
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Function: 0Bh — Verify Diskette Sectors, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


| Code | Description | 


0000h Successful Operation 


if the Number of Sectors to Read field Is zero, 
no action Is performed and this Code is generated. 


- 0001h | Resume Stage after Interrupt | 


} 0002h Resume Stage after Time Delay | 


“g000h Device Busy, Request Refused 
8003h Write Attempted on Write-Protected Diskette _ | 


Media Changed 
Generated If the ABIOS can reset the Diskette 

Change Line signal to not set; data may be transmitted. 
Media Not Present 


Generated if the ABIOS cannot reset the Diskette 
Change Line signal to not set; no data is transferred. 


9009h | Controiler Failure in Reset Operation 
| 9102h Address Mark Not Found 
| 9104h Requested Sector Not Found 


| Controller Fallure _ _ _ 
[eteon | erer SS SSOSCSC~‘S*S 
| coooh Invalid Logical iD 


Cooth Invalid Function 
C003h | Invalid Unit 


|  C004h Invalid Request Block Length | 
| Co00Ch | Unsupported Media Type/Unestablished Media 
-_FFFFh Return Code Field Not Valid 
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Function: 0Ch — Read Media Parameters 


Description 


This function is a discrete multistaged request. It returns the parameters of 
the media used in the preceding diskette function, if the Diskette Change 
Line signal status is not Set. 


This function is intended to be used after requests for either function O8h 
Read Diskette, 09h Verify Diskette, or OAh Format Diskette. 


The ABIOS resets the diskette subsystem if there is a hardware error. 


Request Block Structure 


: 
| 
| 
| 08h _| Word _| | 
| 0An | Word || Reserved {initialize to 0000h) || 


|| Number of sectors per track 


Size of sector (bytes) 


00h = Reserved 
Oih = 256 bytes per sector 
02h = §12 bytes per sector 


-FFFFh = Reserved 


|| Number of heads | 
: Gap Length for Read/Write/Verify 
| 


continued 
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Function: 0Ch — Read Media Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description | 


Successful Operation 


lf the Number of Sectors to Read field is zero, 
no action is performed and this Code Is generated. 


Resume Stage after Interrupt | 
0002h Resume Stage after Time Delay 
~ 8000h Device Busy, Request Refused 


8003h ; | 


Write Attempted on Write-Protected Diskette 
8006h 


Media Changed 

Generated if the ABIOS can reset the Diskette 
Change Line signal to not set. 
Media Not Present 


Generated if the ABIOS cannot reset the Diskette 
Change Line signal to not set. 


Code 


0000h 


800Dh 


9009h Controller Failure in Reset Operation 


Address Mark Not Found 
9104h Requested Sector Not Found 


9108h | DMA Overrun on Operation | 
Bad CRC on Diskette Read | | 


Controller Failure 
Seek Operation Failed 


9180h Error 


~C000h Invalid Logical ID 
Co01ih | Invalid Function 
CO003h Invalid Unit 


C004h Invalid Request Block Length | 
Co0oCh Unsupported Media Type/Unestablished Media 


FFFFh Return Code Field Not Valid 
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Function: 0Dh — Set Media Type for Format 


— Description 


This function is a single-staged request that sets the media information used 
in the format function. This information includes the number of tracks and 
the number of sectors per track. These parameters are used until changed 
by function 04h Set Device Parameters, or until the drive door is opened 
(changing the Change Line signal status to set). 


The ABIOS resets the diskette subsystem if there is a hardware error. 


Warning: If the sector size is changed by this function, the caller must 
restore the sector size to its original value by invoking function 
04h Set Device Parameters immediately after using function ODh. 


ABIOS diskette processing 


If the diskette has been changed since the last time function ODh was 
requested and a diskette is in the drive, the ABIOS sets the specified pa- 
rameters and resets the Diskette Change Line signal to not set. 


Note: request this function before invoking function OAh Format Diskette. 


continued 
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Function: 0Dh — Set Media Type for Format, Continued 


Request Block Structure 


oon t word 
| 06h | Word _ [function (onoeh, ___ 
| o8h_| Word || 
2 qd 
ee : 
Size of sector (bytes) 


Oih = 256 bytes per sector 
O2h = 512 bytes per sector 


Reserved (Initialize to 0000h) = 


Time to wait before continuing 
request (microseconds). Valid only 
if Return Code is 0002h. 


Number of tracks to format 1E 
Fill byte for format 
| Gap Length for format HEE 


continued 
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Function: 0ODh — Set Media Type for Format, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 


all valid bits in the Return Code field to ensure proper performance. 


Successful Operation 


if the Number of Sectors to Read field is zero, no 


0000h 
action is performed and this Code is generated. 


8000h Device Busy, Request Refused 


8006h Media Changed 

Generated if the ABIOS can reset the Diskette 
Change Line signal to not set; data may be transmitted. 

800Dh 
Change Line signal to not set (the diskette drive 
door is open); no data is transferred. 

800Fh Invalid Value in CMOS RAM 

Co00h Invalid Logical ID 

Cooth | Invalid Function 

C003h Invalid Unit Number 


C004h Invalid Request Block Length 
Co005h Invalid Diskette Parameter 


Co00Ch Unsupported Media Type/Unestablished Media 


Invalid input in the Number of Tracks to Format or Number 
of Sectors Per Track fields causes this code to be set. 


FFFFh Return Code Field Not Valid | 


Media Not Present 
Generated if the ABIOS cannot reset the Diskette 
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Function: 0Eh — Read Change Line Signal Status 


Description 


This function is a single-—staged request. It determines if the drive door of 
the specified diskette drive has been opened since the last time the change 
line was cleared. The Change Line Signal Status field is valid only if the 
specified drive supports the Diskette Change Line signal. Function 03h, Read 
Device Parameters specifies if the Change Line signal status is supported. 


The ABIOS resets the diskette subsystem if there is a hardware error. 


This function does not clear the Diskette Change Line signal. 


Request Block Structure | 


Tones] see [mew doe 
| 02h _ | Word _| 
| 04h | Word _ 
| 06h | Word | 
. 


| OCh | Word || Return Code | | "Return Code 
“|| Time-out 


. 
| Byte : | Change Signal Status, where: 


0Oh = Change signal not set 
06h = Change signal set 


continued 
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Function: OEh — Read Change Line Signal Status, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[c000h | wala Logioal iD 
Invalid Unit Number ; 


FFFFh | Return Code Field Not Valid 
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Function: OFh — Turn Diskette Motor Off 


Description 


This function is a single-staged request that turns off the diskette drive 
motor for the specified diskette drive. The caller should request this function 
when the 0000h Successful Operation Return Code is set for those functions 
that may turn the motor on: 

» QO5h Reset/Initialize Diskette 

= 08h Read Diskette 

» 09h Write to Diskette 

» OAh Format Diskette 

» OBh Verify Diskette Data 


The ABIOS resets the diskette subsystem if there is a hardware error. 


Request Block Structure 


| 00h | Word || Request Block Length || 
Word 
, 
Word || Reserved (initialize to 0000h) || ee 


| OEh_| Word | 
| 16h | Byte || Reserved (Initialize to 0000h) : 


continued 
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Function: OFh — Turn Diskette Motor Off, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Function: 10h — Interrupt Status 


Description 
This function is a single-staged request that returns the diskette interrupt 
pending status. This function does not reset the interrupt condition. 


The ABIOS resets the diskette subsystem if there is a hardware error. 


Track switching 


The ABIOS Diskette Service does not support a switch from head 1 of a 
diskette cylinder to head O of the next cylinder. However, it allows you to 
cross track boundaries if you switch from head 0 to head 1 on the same 
cylinder. 


continued 
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Function 10h — Interrupt Status, Continued 


Request Block Structure 


[02h [Word | , 
: 
| osh | Word : 
Return Code 


aye 


| 16h | Word || Reserved (initialize to 0000h) : 


interrupt Pending Status 


0Oh = No interrupt 
Oth = Interrupt pending 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 
0000h Successful Operation 


8000h Device Busy, Request Refused 
Co00h 
| Cooth Invalid Function | 


| C003h Invalid Unit Number : | 
C004h Invalid Request Block Length 


FFFFh Return Code Field Not Valid 


Invalid Logical ID 
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Chapter 9 
ABIOS Fixed Disk Service 


Overview 


Description 


The ABIOS Fixed Disk Service provides access to fixed disk I/O through a 
series of function requests. All ABIOS Fixed Disk Service functions disable 
interrupts upon completion. 


DMA interface 


The ABIOS Fixed Disk Service accesses the ABIOS DMA Service. If the 
ABIOS Fixed Disk Service is used, the ABIOS DMA Service must also be 
initialized. 


continued 


ABIOS Fixed Disk Service 231 


Overview, Continued 


Rules for using the PS/2 BIOS fixed disk services 


Because the CBIOS and ABIOS interface with different operating systems, 

_ either the CBIOS or ABIOS Fixed Disk Service may place fixed disk hardware 
in an unknown state. The CBIOS does not inform the ABIOS of the fixed disk 
hardware state when control is passed from the CBIOS to the ABIOS, and 
vice versa. As a result, it is possible for one part of the PS/2 ROM BIOS to 
put the fixed disk hardware in a state that will not be recognized by the other 
part of the BIOS. | 


Follow the rules listed below to avoid fixed disk problems in the PS/2 BIOS: 


1. If there is an outstanding ABIOS Fixed Disk function request, do not 
request a CBIOS Fixed Disk function. | 


2. If there is an outstanding CBIOS Fixed Disk function request, do not 
request an ABIOS Fixed Disk function. 

3. If using CBIOS and the last Fixed Disk Service function call was to ABIOS, 
request INT 13h, AH = ODh, Alternate Reset Fixed Disk System, before 
invoking other CBIOS Fixed Disk functions. 

4. lf using ABIOS and the last Fixed Disk Service function call was to CBIOS, 
request ABIOS Fixed Disk Service function 05h, Reset Fixed Disk System, 
before invoking other ABIOS Fixed Disk Service functions. 

5. After ABIOS is initialized, the first ABIOS Fixed Disk Service function 
request must be function 05h, Reset Fixed Disk System. 


Fixed disk drive access 


In the ABIOS, fixed disk drives are specified by Logical ID. All fixed disk 
drives may share the same Logical ID, with each drive assigned a separate 
unit number. For example, all fixed disk drives may be Logical ID 11; fixed 
disk drive 0 may be Logical ID 11, Unit 0 and fixed disk drive 1 may be 
Logical ID 11, Unit 1. 


continued 
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Overview, Continued 


Fixed Disk Relative Block addressing 


The ABIOS Fixed Disk Service functions 08h, 09h, OAh, and OBh require 
Relative Block Addresses as input in the Request Block that invokes these 
functions. An RBA is constructed of three elements. The derivation of these 
elements is as follows: 


1. Multiply the Number of Sectors Per Track times the Head Number times 
the Cylinder Number to arrive at the first element of the RBA. 


2. Multiply the Number of Sectors Per Track times the Head Number for the 
second element of the RBA. 


3. The third element is the Sector ID minus one. 
Add all three elements together to arrive at the RBA. 


Relative Block Addresses begin at zero. In relative block addressing the first 
data block is at location 0 on the fixed disk (Cylinder 0, Head 0, Sector 1). 


Relative Block Address input 


Function 03h Read Device Parameters of the ABIOS Fixed Disk Service 
returns actual physical values for the number of sectors per track, number 
of heads, and number of cylinders. When multiplied together, these three 
values indicate the number of Relative Block Addresses on the fixed disk. 
The largest Relative Block Address is one less than that number. 


continued 
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Overview, Continued 


Summary of ABIOS Fixed Disk Service functions 


[con | Befaut nterupt ander 
[01m [Return Logical 10 Parameters 
[oak [reserved 
[aan | ead Device Parameters 
—o4n 
[06h 


= 


Verify Fixed Disk Data 
Fixed Disk Interrupt Status | 


In this chapter 


This chapter includes information about the following topics: 
» Hardware Environment 

» Fixed Disk Service Parameters Table 

=» Error Handling 

=» ABIOS Fixed Disk Service functions 
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Hardware Environment 


Fixed disk controller 


The ABIOS supports up to two fixed disks. The ABIOS supports a 
PS/2-compatible ST506 fixed disk adapter. The ST506 adapter is single— 
tasking and must complete one operation before starting another, even 
though the next operation may be for the other fixed disk. The hardware 
interrupt request for fixed disk is 14. 


RLL and ESDI fixed disk controllers may also be supported by the ABIOS. 


Data Transfer characteristics 


The standard data transfer rate for the fixed disks is 500 kilobits per second 
(Kbs). The largest contiguous block of data that can be transferred at any 


one time is 255 sectors. The time-out value for all fixed disk functions is 
22 seconds. 
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Fixed Disk Service Parameters Table 


Table of fixed disk definitions 


The defined entries into the Fixed Disk Parameters table are listed below. 
Wherever possible, the manufacturer name and model number associated 
with a given drive type are listed in the column, “Manufacturer.” 


| Write \tandine Sectors/ Defect 
| Type iyrenuraeturer Heads a Zone Track <9 | 


IBM 20 MB 
Seagate ST-225 
CDC Wren Il 


9415-5-25 
Miniscribe 8438F 


=a IBM 30 MB 
IBM 62 MB 
IBM 46 MB 


= 
| os | ca 
W ce ais 
Miniscribe MS 8425 
Seagate ST4026 | 
| Tandon TM 262 | 
Tandon TM 702AT } 


7 IBM 30 MB 


IBM 30 MB 


Seagate ST-4038 
CDC Wren Il 


Pets | 
| 940 
| 940 
em 
Tandon TM 703AT 


ce | No 
of 8 | No_| 
mz | No 

a2 {oe | p17 | No 
Z : pe | aa 
[oo | eMi2Me 112 MB | ze 7 | No | 
| to | wm zome | 820 | 3 | No_| 
pn | om poten! 
[2 ae | No 
| 13 | 8 | No_ | 


= 
<< — 220_| 
Tie sswe | oss | 8 [orerrn| e658 | 7 
Ta =< 
[06 = 


OFFFFh* 
IBM 20 MB 


* If a table entry contains OFFFFh for Write precommeneation. then there is no write 
precompensation for this disk. If the Write Precompensation Is zero, then there is write 
precompensation for ail cylinders. 
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Fixed Disk Service Parameters Table, Continued 


Table of fixed disk definitions, cont’d 


Write Landing | Sectors/ | Defect 
Type Manufacturer Cyl. | Heads | Precomp Zone Track Map 


Te [ewaewe | ee [7 _forerem [ree [7 | ne | 
A 


Not used 


ie [ewrome oe | CN 
Ts [se [or [a 
roererne | arr [1 


lee cae 
= [ar 
foe [eADeA | 
ee noe 
[at [738 
= [738 
| 23 [306 
oe EL ee ee 
[25 [em iowe [305 
| 28 | | ore | 
Lee] eee 
Le es 
[20 [306 
eae, eit. 
ei [732 
ed se 


_ 
| 


IBM 20 MB 


= 
a7 
[06 | 680 _| 
200782 

| 1023 


IBM 42.5 MB OFFFFh* 


* If a table entry contains OFFFFh for Write Precompensation, then there is no write 
precompensation for this disk. If the Write Precompensation is zero, then there is write 
precompensation for all cylinders. 


ae 
eae, 
8 
oes 
Loe. 
4 
be 
| 4 | OFFFFh* 
a 
7 | 300 | 
| 8 | 488 
| 4 | OFFFFh* | 
Ld 
aie 
Lee 
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Error Handling 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


If Bit 15 of the Return Code field is set, the fixed disk function requested has 
an error. The caller’s Return Code handler routine should then test Bits 14, 
13, 12, and 8 to determine the class of error that has occurred. The return 
code handler routine should then test the remaining bits to determine the 
precise nature of the error. 


Retryable fixed disk errors 


When Bit 8 (Retryable Error) of the Return Code is set, the request should 
be retried. The recommended number of retries is returned by Diskette 
function 03h, Read Device Parameters (in offset 1Dh in the Request Block). 
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Function: 00h — Default Interrupt Handler 


Description 


This function is a single-staged request that handles unexpected hardware 
interrupts by resetting the interrupt at the device level. It is invoked through 
the interrupt routine. 


When invoked 


This function is invoked by calling the interrupt routine with a function code 
of O000h. It is only invoked if a given Logical ID has no outstanding Request 
Blocks waiting for an interrupt. 


Request Block Structure 


| 00h | Word _ Ee 
[02h Word | 


| Function (0000h) 
|_08h | Word _ 
| OAn | Word _| e . 


Return Code 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0000h Successful Operation 
}  0005h Not My Interrupt, Resume Stage after Interrupt 


[Fern _|Retumn Code Fed Not vag S—S 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns the parameters for the 
specified Logical ID. 


Request Block Structure 


aE 
|| Request Block Length (20h) | 


qf Return Code 4 


‘| Hardware Interrupt Level (14h, 
|] OEn) | 


||Atbitration Level (00h through Oh) _ 
||Device 1D (0002h) 
|[[Count of Units CS 
1] Logical ID Flags 


Bits 15-4 = Reserved 
Bit 3 = 0 No overlap across 
, units 
Bit 2 = 0 Reserved 
Bits 1-0 = Transfer Data Pointer 


Mode 
10b= Physical Pointer 
Required 


|| Request Block Length (for other 
11 functions) 


Reserved (initialize to 0000h) ; Secondary Device iD 


fee “|| Revision Level — | aa 
Reserved (initialize to 0000h) | : 
|; Reserved (initialize to 0000h) 


continued 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Function: 02h — Reserved 
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Function: 03h — Read Device Parameters 


Description 


This function is a single-staged request that returns the parameters for this 

device in the Request Block as specified below. The information returned 

applies to the maximum capacity of the media for the specified drive type. 
_ All ABIOS Fixed Disk Service functions disable interrupts upon completion. 


Software retries 


This function returns a recommendation for the Number of Retries (at offset 
1Dh) performed by the caller when a Retryable error (Bit 8 in the Return 
Code field) is set. 


Fixed disk hardware error conditions 


The ABIOS resets the Fixed Disk subsystem if there is a fixed disk hardware 
error. 


Request Block structure 


Reserved (initialize to 0000h) oe oe 


| Sectors per track associated with | 
requested unit | | 
Size of Sector (bytes) ) 
0Oh-Oth = Reserved 
02h = §12-byte sectors 
O3h-FFFFh = Reserved 
Drive Type, where: 
00h = Drive Type 1 

| Oth = Drive Type 2, etc, up to 

2ih = Drive Type 33 


continued 
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Function: 03h — Read Device Parameters, Continued 


Request Block structure, cont'd 


Word 1; Device Control Flags 


Bits 15-13 = Reserved 
Bits 12-11 = Format support 
00 No format 
support 
01 Format track 
support 
10 Format unit 
support 
11 Track/unit 
support 
Bit 10 = ST506 drive 
0 No ST506 
1 ST506 
Bit 9 = Concurrent unit 
requests 
0 Not concurrent 
: 1 Concurrent 
|} Bit 8 = Ejecting capability 
0 No ejecting 
1 Ejecting 
Bit 7 = Media organization 
0 Random 
1 Sequential 
Bit 6 = Locking capability 
0 No locking 
1 Locking 
Bit 5 = Read capability 
0 Not readable 
1 Readable 
Bit 4 = Caching support 
0 No caching 
1 Caching 
Bit 3 = Write frequency 
0 Write once 
1 Write many 
Bit 2 = 1 Change signal 
7 supported 
‘|| Bits 1-0 = Reserved 
|| Number of cylinders associated 
1] with requested unit 


|| Number of heads associated with 

|{|_ requested unit 

\| Suggested number of software 
||_retries | 

1] Number of Block Addresses 

| Se ‘|| associated with requested unit 
DWord || Reserved (Initialize to 0000h) 


|| Reserved 
|| Maximum number of blocks to 
‘|| transfer for one call | | 


continued 


DWord 
Byte 


Byte 


oO 
$|Z| 2 
als} 8 

a 


Word 


| 24h | 
| _28h_| 
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Function: 03h — Read Device Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0000h 


C004h Invalid Request Block Length 
FFFFh Return Code Field Not Valid 


Function: 04h — Reserved 


Function: 05h — Reset/Initialize Fixed Disk 


Description 


This function is a discrete multistaged request that resets the fixed disk 
subsystem (both hardware and software) to a known state. Setting the fixed 
disk drives to a known state involves resetting the fixed disk controller, which 
generates an interrupt to which the caller must respond, and recalibrating 
the drives on the next fixed disk access. All ABIOS Fixed Disk Service func- 
tions disable interrupts upon completion. 


continued 
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Function: 05h — Reset/Initialize Fixed Disk, Continued 


Switching between ABIOS and CBIOS 


Invoke this function after switching from CBIOS to ABIOS and before invoking 
any other ABIOS Fixed Disk Service functions. 


Software retries 


Function 03h Read Device Parameters returns the Number of Retries (at 
offset 1Dh in the Request Block) to attempt for a Fixed Disk Service function 
when a Retryable error (Bit 8 in the Return Code field) is set. 


Fixed disk hardware error conditions 


The ABIOS resets the Fixed Disk subsystem if there is a fixed disk hardware 
error. 


Request Block Structure 


: 
: 


Word || Reserved (initialize to 0000h) 


Lc ae | ReturnCode sd 
[0Eh | Word || =="! Time-out 


Reserved (Initialize to 0000h) a a 4 
DWord ||: || Time to Wait Before Continuing 
: 1} request (microseconds). Valid on 
: {| lf Return Code is 0002h. 


continued 
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Function: 05h — Reset/Initialize Fixed Disk, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0000h Successful Operation: If the Number of Blocks to Read field 
Is zero, no processing occurs, and this code is generated. 


| 00th | Resume Stage after Interrupt 
Resume Stage after Time Delay 


| 0002h 

[000s [Not My Iterrup, Resume Stage ater terre 
|__soorn | DMA Arbitration Level Qut of Range 
|_sooth | Badcommand 
Address Mark Not Found 

| 9004 Record Not Found 

[s00sn | Reset Fated 
| 900Dh__| Invalid Sector on Format 
[s00en | CAM Detected During Read or Very 


9020h Bad Controller 


Equipment Check 
9040h Bad Seek 


9080h Device Did Not Respond 


90AAh Drive Not Ready 
90BBh Undefined Error 


90CCh | Write Fault 


SOFFh Incomplete Sense Operation | 
9105h Reset Failed 


| 9107h Controller Parameter Activity Failed 


continued 
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Function: 05h — Reset/Initialize Fixed Disk, Continued 


Return Codes, cont’d 


Bad Controller 
Equipment Check 


9180h Device Did Not Respond 


| 91AAh_ | Drive Not Ready 
91BBh Undefined Error 


91CCh Write Fault 
91FFh Incomplete Sense Operation 


A000h Time-out Occurred — No Other Error 


[—aooin | Bad Command SSCSC~—~S~—“—Ss~S~S~SY 
[Aaoen | RecorsNotrownd —SSCSC~S~SCS 
[Aooeh [Bed track SSCS 
| “Asoeh | GAM Detected During Read or Very 


A010h | Uncorrectable ECC or CRC Error 
A011h | ECC Corrected Data Error 


A020h Bad Controller _ 


A02th Equipment Check 
A040h_ | Bad Seek | | 


[AowAn [Drive Not Ready CS 
Undefined Error | 


AOFFh incomplete Sense Operation 


A100h | Time-out Occurred — No Other Error 


continued 
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Function: 05h — Reset/Initialize Fixed Disk, Continued 


Return Codes, cont’d 


A105h Reset Failed | 
A107h Controller parameter Activity Failed 
A120h Bad Controller 


Undefined Error 
| Bozth | Equipment check 


Bi2th Equipment Check 


| BiBBh | Undefined Errore 
Invalid Unit Number | | 


C004h Invalid Request Block Length 


Co05h Invalid Fixed Disk Parameter: If Number the of Blocks to 
| Read js greater than 255, no processing occurs, and this 


code is returned. 


FFFFh Return Code Field Not Valid 
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Functions: 06h —- 07h — Reserved 


Function: 08h — Read Fixed Disk 


Description 


This function, a multistaged request, reads the amount of data specified in 

the Number of Blocks to Read field from the specified location on the fixed 

disk to the location specified in Data Pointer 2. All ABIOS Fixed Disk Service 
functions disable interrupts upon completion. 


Fixed disk hardware error conditions 


The ABIOS resets the Fixed Disk subsystem if there is a fixed disk hardware 
error. 


Software retries 


Function 03h Read Device Parameters returns the Number of Retries (at 
offset 1Dh in the Request Block) to attempt for a Fixed Disk Service function 
when a Retryable error (Bit 8 in the Return Code field) is set. 


continued 
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Function: 08h — Read Fixed Disk, Continued 


Request Block 


eS Ce ae 


om | wera , 
04h _| Word 

: 
Word __ 
|_0Eh_ | Word _| | 
2 


DWord Reserved 


46h | Word || Reserved (Initialize to 0000h) 
—1en_| Word} Reserved (Initialize to 0000h) : 


DWord || Data Pointer 2 (32-bit physical 
data pointer required) =: 
Reserved (Initialize to 0000h) 


DWord || Relative Block Address 
DWord || Reserved (Initialize to 0000h) ee eee 


Time to wait before continuing 
request (microseconds). Valid only 
if Return Code is 0002h. 


Number of blocks read (not up- 
dated if Return Code is CO05h). 
Number of blocks transferred if 
successful or partially successful. 
Only valid if request is complete. 


; Number of blocks to read 
(amount of data to be trans- 
ferred) 


Caching 


Bits 7-1 = Reserved (set to 0) 
Bit 0 = Caching 
0 = Caching Is OK 
for this request 
1 = Do not cache oe 


Soft Error Occurred: if adapter de- 
tected and corrected an error, the 
recovered error code is displayed. 


0000h = no error. 


Return Codes 


All Return Codes valid for the ABIOS Fixed Disk Service may be returned by 
the ABIOS in response to this function. See the Return Codes list for Func- 
tion 05h — Reset/Initialize Fixed Disk. 


250 ABIOS for IBM PS/2 Computers and Compatibles 


Function: 09h — Write to Fixed Disk 


Description 


This function, a discrete multistaged request, writes the amount of data 
specified in the Number of Blocks to Write field from the location specified in 
Data Pointer 2 to the Relative Block Address on the fixed disk. All ABIOS 
Fixed Disk Service functions disable interrupts upon completion. 


Fixed disk hardware error conditions 


The ABIOS resets the Fixed Disk subsystem if there is a fixed disk hardware 
error. 


Software retries 


Function 03h Read Device Parameters returns the Number of Retries (at 
offset 1Dh in the Request Block) to attempt for a Fixed Disk Service function 
when a Retryable error (Bit 8 in the Return Code field) is set. 


continued 
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Function: 09h — Write to Fixed Disk, Continued 


Request Block Structure 


Povwei] ome [mowed 
| 00h | Word _ : 
| 02h _ | Word | 
| 04h _| Word _| 
—2eh_|_ ord 
| . 


x ak. er 
| 16h | Word |! Reserved (Initialize to 0000h) 

| 18h | Word _ 
| 1Eh | Word _ 
zon [pWerd | 
—2ih__OWerd. 


Time to Walt Before Continuing 
Request (microseconds). Valid 
only if Return Code is 0002h. 


Number of blocks written (not up- 
dated if Return Code is CO05h). 
Number of blocks transferred if 
successful or partially successful. 
Only valid if request is complete. 


Number of Blocks to Write: If 
zero, no processing occurs; Re- 
turn Code Is 0000h; if > 255, Re- 
turn Code is C005h, no process- 
ing occurs. 


Caching COD Percecelerenensesesecsanssatesstanctarstatatatetst tstateratetstateatltstititytsetescoetetetateteteratymeteteasetatetsetetetstitety sty 


Bits 7-1= Reserved (set to 0) 
BitO =Caching 
0 = Caching is OK 
for this request 
1 = = Do not panne 


Soft Error Occurred: if adapter 
detected and corrected an error, 
the recovered error code is dis- 
played. 


0000h = no error. 


Return Codes — 


All Return Codes valid for the ABIOS Fixed Disk Service may be returned by 
the ABIOS in response to this function. See the Return Codes list for Func- 
tion 05h — Reset/Initialize Fixed Disk. 
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Function: 0Ah — Write and Verify Fixed Disk 


Description 


This function, a multistaged request, writes data to the fixed disk (just as 
function 09h does), then immediately verifies that same data (as function 
OBh does). 


Software retries 


Function 03h Read Device Parameters returns the Number of Retries (at 
offset 1Dh in the Request Block) to attempt for a Fixed Disk Service function 
when a Retryable error (Bit 8 in the Return Code field) is set. 


Fixed disk hardware error conditions 
The ABIOS resets the Fixed Disk subsystem if there is a fixed disk hardware 
error. 


continued 
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Function: 0Ah — Write and Verify Fixed Disk, Continued 


Request Block structure 


| 02h | Word _| , 
[oan | Word : 
[10 Word 

[12h] DWord 
| 16h | Word 
1h Word 
[20h | DWord” 


= [onl : Time to Walt Before Continuing 


Request (microseconds). Valid only 


if Return Code Is 0002h. 
Number of blocks written and veri- 
wi 
2Fh Word {fe ee ES Soft Error Occurred: If eaapterc a: 
tected and corrected an error, the 
: recovered error code is displayed. 
Le ee 0000h = no error. 


fled (not updated if Return Code is 
| 31h | Word | Reserved for Subfunction oh 


No. of Blocks to Write/Verify. — 
If the input is zero, no process- 
ing occurs. If the input is > 255, 
no processing occurs and the 
Return Code is set to CO005h. 


C005h). Number of blocks written/ 
verified if successful or partially 

successful. Only valid if request is 
complete 


Caching 


Bits 7-1= Reserved (set to 0) 
BitO =Caching 

0 = Caching OK 

1 = Do not cache ES 


Return Codes 


All Return Codes valid for the ABIOS Fixed Disk Service may be returned by 
the ABIOS in response to this function. See the Return Codes list for Func- 
tion O5h — Reset/Initialize Fixed Disk. 
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Function: OBh — Verify Fixed Disk Data 


Description 


This function, a discrete multistaged request, verifies the readability of the 
data on the fixed disk. Data is read but is not transferred. All ABIOS Fixed 
Disk Service functions disable interrupts upon completion. 


Software retries 


Function 03h Read Device Parameters returns the Number of Retries (at 
offset 1Dh in the Request Block) to attempt for a Fixed Disk Service function 
when a Retryable error (Bit 8 in the Return Code field) is set. 


Fixed disk hardware error conditions 


The ABIOS resets the Fixed Disk subsystem if there is a fixed disk hardware 
error. 


continued 
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Function: 0Bh — Verify Fixed Disk Data, Continued 


Request Block Structure 


Fe 


ooh | Word _ noRonnennoneennoannos|oRoElEgnongEoSnEOgloneOOonop OOS Sne DOR CRIOnnOS : 
| 02h | Word _| 
SEES Eee 
S LL 
Coo 
: 


Reserved (initialize to 0000h) 


Time to wait before continuing 
request (microseconds). Valid only 
if Return Code is 0002h. 


| 20h | 
Word Number of Blocks to Verify — If Number of Blocks Written (contains 
> 255, no processing occurs. If number of blocks verified if Return 


zero, Return Code is CO005h. Code is 0000h). 


Byte Caching 
Bits 7-1= Reserved 
BitO0 | =Caching allowed 


Word Soft Error Occurred: if adapter de- 
tected and corrected an error, the 


recovered error code is displayed. 
0000h = no error. 


Return Codes 


All Return Codes valid for the ABIOS Fixed Disk Service may be returned by 
the ABIOS in response to this function. See the Return Codes list for Func- 
tion O5h — Reset/Initialize Fixed Disk. 
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Function: 0Ch — Fixed Disk Interrupt Status 


Description 


This function, a single-staged request, returns the fixed disk controller 
interrupt pending status. All ABIOS Fixed Disk Service functions disable 
interrupts upon completion. 


The interrupt Condition is not reset by the ABIOS. 


Logical ID 


The Interrupt Status field applies to the fixed disk controller Logical ID and 
not to any individual diskette drive (Unit) entered in the Request Block by 
the caller. 


Interrupt Status field 


A parameter error in the input to the Request Block will cause the Interrupt 
Status field to be invalid. The Interrupt Status field indicates if any interrupts 
are currently pending from the interrupt controller. 


Fixed disk hardware error conditions 


The ABIOS resets the Fixed Disk subsystem if there is a fixed disk hardware 
error. 


Software retries 


Function 03h Read Device Parameters returns the Number of Retries (at 
offset 1Dh in the Request Block) to attempt for a Fixed Disk Service function 
when a Retryable error (Bit 8 in the Return Code field) is set. 


continued 
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Function: 0Ch — Fixed Disk Interrupt Status, Continued 


Request Block Structure 


| 00h | Word || Request Block Length = 
Logical ID 


| 06h | Word | 
| 08h | Word _ : 
| 0Ah | Word | SOS eee 
0Ch 

h a 


10h Byte : Interrupt Status 
00h = Interrupt not pending 
Oth = Interrupt pending 
JS SSS SESS. 1 SESS , O2h-FFh = Reserved a 


| 16h | Word |] Reserved (Initialize to 0000h 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 
Successful Operation 
Co000h Invalid Logical ID 

Invalid Function 
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Chapter 10 
ABIOS Keyboard Service 


Overview 


Description 


The ABIOS Keyboard Service provides an interface between the operating 
system and IBM PS/2-compatible keyboards. The functions available provide 
the user with a means of accessing the keyboard which is independent of 
hardware specifics. To maintain maximum compatibility across different 
keyboard controllers, direct hardware programming of a controller should be 
avoided. 


continued 
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Overview, Continued 


Summary of Keyboard Service functions 


orm [Return Cocca Parameters 
a 
[aan | Read Keveoars@ Byes 
van | contnsous KeyboaraRead 
[06h | ead Keyboard LE Sats 
aon [ Set Typematic Rate andDoay 
[ton | wrte Command(s) to Keyboard Gonivelor 
i 


Write Command(s)/Data to Keyboard 


In this chapter 


This chapter includes information about the following topics: 
» Hardware Environment 

= 101-key Keyboard Layout 

=» Scan Codes 

= System Scan Codes 

» Error Handling 

» ABIOS Keyboard Service functions 
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Hardware Environment 


Introduction 


The ABIOS supports an intelligent Keyboard subsystem based on the Intel 
8042 or equivalent keyboard controller. 


The hardware interrupt level associated with the ABIOS Keyboard Service is 
IRQ 1. 


The 8042 controller chip 


The Intel 8042 peripheral controller (or compatible) is a single-chip micro- 
computer that can be programmed to allow bidirectional communication 
between the master microprocessor and up to two auxiliary serial input 
devices. The 8042 chip, generally, is mounted on the system motherboard. 
8042 programs reside as firmware in the 8042 chip itself. 


Device support 


The kind of devices a given 8042 chip supports are dependent on how the 
8042 is programmed. 


On IBM PS/2-compatible systems, the 8042 is programmed to allow bi- 
directional communication between the system and the keyboard, as well as 
between the system and one other auxiliary serial device, such as a mouse, 
joystick, or trackball. 
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101-Key Keyboard Layout 


Keyboard layout 
The figure below depicts the key arrangement and key number system 
applied to the typical 101—key keyboard. 


nl 
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Scan Codes 


Introduction 
The keyboard hardware generates two kinds of keyboard codes: keyboard 


scan codes and system scan codes. The illustration below defines each type 


of code and shows their relationship to the ABIOS Keyboard Service. 


Keyboard scan codes 


Each time a key is pressed, the keyboard hard- 
ware generates a keyboard make or break scan 
code. Keyboard scan codes are not understand- 
able to the system. 


Keyboard 
Make/Break 
Scan Codes 


8042 
Keyboard 


System scan codes 
Controller 


Among other things, the firmware resident in the 
8042 keyboard controller chip must translate all 
keyboard scan codes into “system scan codes” 

| . (i.e. codes that are understandable to the sys- 
Make/Break 


tem). As it translates each code, the 8042 firm- 
System ware deposits It in the 8042’s output buffer. 
Scan Code 


Function 08h — Continuous Read 


The ABIOS Keyboard Service Function 08h, Con- 
tinuous Keyboard Read, retrieves system scan 
codes from their buffer in the 8042 keyboard con- 
troller chip and returns them in offset 14h of the 
function 08h Request Block. 


Function 08h signals the operating system that a 
keystroke is available by outputting Return Code 
0009h, Attention, Resume Stage after Interrupt. 


The operating system is responsible for providing 
any further processing of the system scan code. 


Keyboard Service 
Function 08h 
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System Scan Codes 


The following system scan codes, including multi-byte codes, can be used 
for the Write Password, Write Invocation and Write Match Byte functions. 


egooura System Scan 
Key # Legend Codes (hex) 


Typewriter/Function dade 


ee cesakd System Scan 
| Key # Legend _ Codes (hex) 


Caps Lock 


7 
m 


N 


102- key only 


L Shift 
102-key only 


~“ > 


—_ 
co 


no 
Q) 
b 
> 


sje 
© 


A | © 
wo 1 


no 
> 


continued 


264 | | ABIOS for IBM PS/2 Computers and Compatibles 


System Scan Codes, Continued 


Typewriter/Function Keys, cont’d 


U.S. 
Keyboard | System Scan 
Legend Codes (hex) 


6 Right 


U.S. 
Keyboard | System Scan 
Codes (hex) 


Enter 


E0-5A 


. 
: 
: 
. 


F5 


i 
1 
2 
3 
4 
F6 
F7 
F8 
F9 
p21 F10 


122 Fit 


7D 
74 
7A 
71 
7B 
79 
76 
04 
oc 
03 
0A 
78 
125 | Scroll Lock 


continued 
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System Scan Codes, Continued 


Other keys 


The rest of the keys send a series of codes that depend on the state of the 

shift keys (Ctrl, Alt, and Shift) and the Num Lock key (On or Off). Since the 
base scan code is the same as that for another key, an additional code (hex 
EO) is added to the base code so that it is unique. The following four tables 

summarize the scan codes for these other keys. 


Cursor/Control Keys 


| U.S. Base Case or 

| Keyboard Shift + | . 
Key # Legend Num Lock Shift Case* Num Lock on 

75 insert . E0-70 EO FO EO 12 

| | 12 EO 70 EO 70 

76 Delete E0-71 EO FO EO 12 

12 EO 71 EO 71 

79 Left EO-6B EO FO EO 12 

12 EO 6B EO 6B 

80 - EO FO EO 12 

12 EO 6C EO 6C 


7 EO FO EO 12 
12 EO 7D EO 7D 
86 Page Down E0-7A EO FO EO 12 
| 12 EO 7A EO 7A 
E0-74 EO FO EO 12 
12 EO 74 EO 74 
* With the Left Shift key down, the FO 12 shift code is added to the other scan 


codes sent. With the Right Shift key down, FO 59 is added. When both keys are 
down, both sets of codes are sent with the rest of the scan code. 


continued 
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System Scan Codes, Continued 


“1” Key on Numeric Keypad 


U.S. Keyboard System Scan Codes 
Key # Legend (hex) Shift Case* 
/ E0 4A EO FO 
12 EO 4A 


* With the Left Shift key down, the FO 12 shift code Is added to the other scan 
codes sent. With the Right Shift key down, FO 59 Is added. When both keys are 
down, both sets of codes are sent with the rest of the scan code. 


Print Screen/Sys Req Key 


Mevoscra System Scan Ctri Case 
Key # Legend Codes (hex) Shift Case Alt Case 
Print Screen EO 12 EO 7C | 
EO 7C 
Pause/Break Key 
U.S. Keyboard System Scan Codes 
Key # Legend (hex) Ctri Key Pressed | 
Pause E114 77 EO 7E EO 

E1 FO 14 FO 7E | 
FO 77 | 
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Error Handling 


Description 


The ABIOS Keyboard Service assumes that the operating system will handle: 


m Hardware errors 
The ABIOS does not reset the keyboard after a keyboard hardware error. 
It is the operating system’s responsibility to execute function 05h Reset/ 
Initialize Keyboard every time there is a hardware error. 

= Time-out error retries 
The ABIOS Keyboard Service resets the keyboard after time-out errors. 


How errors are reported 


268 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


If Bit 15 of the Return Code field is set, the keyboard function requested has 
an error. The caller’s Return Code handler routine should then test Bits 14, 
13, 12, and 8 to determine the class of error that has occurred. The return 
code handler routine should then test the remaining bits to determine the 
precise nature of the error. 
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Function: 00h — Default Interrupt Handler 


Description 


This single-staged function handles unexpected hardware interrupts by reset- 
ting the interrupt at the device level. 


How and When to invoke 


This function is invoked by calling the interrupt routine with a function code 
of O0OOOh. It is only invoked if a given Logical ID has no outstanding Request 
Blocks waiting for an interrupt. 


7 Block Structure 


iS Logical ID 


a 


Request Block Length ee 
Unit 


| Function (0000n) —s—s—sis 0000h 
Reserved | Reserved (initialize to 0000h) sis to 0000h 
Reserved | Reserved (initialize to 0000h) | to 0000h) 


| ReturnCode Code Rous Code 


| 06h _| Word _| 
— ath} ond | Word _| 
| OAh | Word 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[—o0osh | Not My iterut, Resume Stage ater mterupt 
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Function: 01h — Return Logical ID Parameters 


Description 


This single-staged function returns the parameters for the specified Logical 
ID. 


Request Block Structure 


_||_Request Block Length (20h) Hy 
| Logical IDCs 


OAh Reserved (initialize to 0000h) 


Logical ID flags 


Bits 15-4 = Reserved 
Bit 3 = 0 No overlap across 
units 
= 1 Overlap across units 
supported 
Bit 2 =Q0 Reserved 
Bits 1-0 = Transfer Data Pointer 
Mode | 
00 =No Pointers 
Required 


Request Block Length (for other 
2) functions) 


~ Reserved (initialize to 0000h) _—*||. Secondary Device ID 


oe 3 Revision Level 
Reserved (initialize to 0000h) s 
Reserved (initialize to 0000h) e 


continued 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Function: 02h — Reserved 
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Function 03h — Read Keyboard ID Bytes 


Description 


This function generates a multistaged request that returns the keyboard 
identification code which indicates the keyboard type. 


Keyboard ID code 


The Keyboard ID is a two-byte code. Function 03h returns the low byte of 
the keyboard ID in offset 14h of the function 03h Request Block. The high 
byte of the keyboard ID is returned in offset 15h. 


Request Block Structure 


ee 


[02h | Word — 
[8h | Word _ 
. 


Ra Time-out 


Time, in microseconds, to Walt Be- 
j| fore Continuing Request 

| (Valid only if Return Code = 0002h) 
| Keyboard ID low byte 

11 Keyboard ID high byte 


Reserved (Initialize to 0000h) If 


i 
oO 
<x 
a. 


continued 
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Function: 03h — Read Keyboard ID Bytes, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[Description 
[001m | Resume Stage after interrupt 
[0005n [Not My Interrupt, Resume Stage after Interrupt 
Attention, Resume Stage after interrupt 


8000h Device Busy, Request Refused 


8003h Security Enabled, Keyboard Inhibited — Request Refused 


[soon | Keyboard Faled Reset 
[—sooen | Resend error 
[a00an | General Hardware Tine-out 
[100% | Keyboard Conroler Perpetualy Busy 
[—ei0en [Resend error 


| BOOth Keyboard Error : 


Keyboard Error 
The caller should invoke function 05h Reset/Initialization 
after a keyboard hardware error. 
Co00h Invalid Logical ID 
Cooth Invalid Function 


C003h_—_|{_ Invalid Unit Number | | 


C004h | Invalid Request Block Length 


C005h invalid Keyboard Parameter | | 
FFFFh Return Code is Not Valid 
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Function: 04h — Reserved 


Function: 05h — Reset/Initialize Keyboard 


Description 


This function generates a multistaged request that resets the keyboard 
hardware and turns off the Caps Lock, Num Lock, Scroll Lock LEDs. 


Keyboard Reset 
The ABIOS does not reset the keyboard after a keyboard hardware error. 


Note: It is the operating system's responsibility to execute function O5h 
Reset/Initialize Keyboard every time there is a hardware error. 


Request Block Structure 


| 00h | Word || Request Block Length : S 

[oan] Word | "Logical 1 

—24n_| Word | : 

Function {O005h 

om wer Reserved (initialize to 0000h : 

Reserved (initialize to 0000h) : 
11 Time, in microseconds, to wait be- 


fore continuing request 
(Valid only if Return Code = 0002h) 


DWord 


| 16h | Word — ~ Reserved (Initialize to 0000h) 


continued 
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Function: 05h — Reset/Initialize Keyboard, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 


all valid bits in the Return Code field to ensure proper performance. 


Code 
0000h 
0001h 


Description 

Successful Operation 

Resume Stage after Interrupt 

Resume Stage after Time Delay 

Not My Interrupt, Resume Stage after Interrupt 
0009h 
8000h 
8003h 
9000h 
9001h 
9002h 
9003h 


Attention, Resume Stage after Interrupt 

Device Busy, Request Refused 

Security Enabled, Keyboard Inhibited — Request Refused 
Keyboard Controller Perpetually Busy 

Keyboard Failed Reset 


Resend Error 

Keyboard Parity Error 
General Hardware Time-out 
9006h Undefined Mode Returned by Keyboard 
9100h Keyboard Controller Perpetually Busy 
Keyboard Falled Reset 


Resend Error 


Keyboard Parity Error 
9104h 
Booth 


General Hardware Time-out 

Keyboard Error 

The Goerctne custen: should invoke function 05h Reset/ 
Initialization after a keyboard hardware error. 

C000h 
Cooth 
C003h 
C004h 
C005h 


FFFFh 


Invalid Logical ID 

Invalid Function 

Invalid Unit Number 

Invalid Request Block Length 
Invalid Keyboard Parameter 


Return Code is Not Valid 
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Function: 06h — Enable Keyboard 


Description 


This function generates a multistaged request that enables the keyboard, 
allowing data from the keyboard to be passed to the system. 


Request Block Structure 


a 


| 00h | Word _ Request Block Length 
| Logical ID ir 


Function (0006h) I 

Reserved (Initialize to 0000h 

| _oAh | Word |{ Reserved (initialize to 0000h) 
R 


[och [Word || "Return Code [Return Code 
[0en_| Word |} 3 


DWord || Time to wait before continuing 
1] request (microseconds) 


| 16h | Word |{ Reserved (Initialize to 0000h) a 


00h | 
02h 
04h 
06h 
08h 
OA 
OCh 


continued 
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Function: 06h — Enable Keyboard, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Code Description — 


Cooth Invalid Function 
C004h Invalid Request Block Length 


FFFFh Return Code is Not Valid 
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Function: 07h — Disable Keyboard 


Description 


This function generates a multistaged request that disables the keyboard, 
inhibiting the flow of data from the keyboard to the system. 


nedues Block Structure 


a 


eon we | Request Block Length : 
Logical iD 


Function (0007h 
| 08h | Word || Reserved (initialize to 0000h | 


_0Ah_| Word || Reserved (initialize to 0000h) || hh 

|_0Ch 
i: ; request (microseconds) 

[ten [Word r <o 


continued 
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Function: 07h — Disable Keyboard, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[o0cah | Resume Stage after Time Delay 
[2000 | Devoe Gury, Request Retiwes id 


8003h Security Enabled, Keyboard Inhibited — Request Refused 
9000h Keyboard Controller Perpetually Busy 


| 9100h_—s Keyboard Controller Perpetually Busy 
Co00h Invalid Logical ID 
Cooth Invalid Function 


CO003h Invalid Unit Number 
C004h Invalid Request Block Length 


Co005h Invalid Keyboard Parameter | 
Return Code is Not Valid 
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Function: 08h — Continuous Keyboard Read 


Des 


cription 


This function generates a continuous multistaged request that retrieves 
system scan codes as they are generated by the 8042 keyboard controller 
chip from I/O port OO060h and signals the operating system that a keystroke 
is available for processing. 


When to invoke function 08h 


Since no keystrokes can be processed unless function 08h has been suc- 
cessfully invoked, function 08h should be invoked immediately after ABIOS 
initialization. 


What is a raw system scan code 


280 


The keyboard hardware generates two kinds of keyboard codes: keyboard 
scan codes and system scan codes. 


= Keyboard scan codes 


Each time a key is pressed, the keyboard hardware generates a keyboard 
make or break scan code. Keyboard scan codes are not understandable 
to the system. 


m System scan codes 


The firmware resident in the 8042 keyboard controller chip translates all 
keyboard scan codes into “system scan codes” (i.e. codes that are 
understandable to the system). As it translates each code, the 8042 
firmware deposits it in the 8042’s output buffer. 


Function O8h retrieves system scan codes from their buffer in the 8042 
keyboard controller chip and returns them in offset 14h of the Request 
Block. Function O8h signals to the operating system that a keystroke is 
available by sending Return Code 0009h Attention, Resume Stage after 
Interrupt. 


continued 
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Function: 08h — Continuous Keyboard Read, Continued 


Request Block Structure 


Request Block Length . Oe - 
| Word Logical ID 


Word Function (0008h 


: 
, 
| : 


Reserved (Initialize to 0000h) 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 
0000h Successful Operation 
Resume Stage after Interrupt 


| 0005h Not My Interrupt, Resume Stage after Interrupt 


0009h Attention, Resume Stage after Interrupt 
8000h Device Busy, Request Refused | | 
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Functions: 09h - 0Ah — Reserved 


Function: OBh — Read Keyboard LED Status 


Description 


This single-staged request returns the status of the keyboard Caps Lock, 
Scroll Lock, and Num Lock LEDs. 


Function OBh limitations 


The data returned by function OBh reflects the state of the Keyboard LED 
status byte after the last successful call of either function O5h, Reset/Initialize 
Keyboard or function OCh Write Keyboard LED Status. 


When function 11h, Write Keyboard Command, is used to set the Keyboard 
LEDs, the value returned by function OBh may not be reliable. 


continued 
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Function 0OBh — Read Keyboard LED Status, Continued 


Request Block Structure 


Aen ee TO 
: 
| 04h | Word | 
| 06h _| Word | 
| 08h_| Word _| 
OCh 

| Word |] | 
1! Keyboard Indicator LED Status 


Bits 7-3= 1 Reserved 

Bit 2 = 1 Caps Lock on 
Bit 1 1 Num Lock on 
Bit 0 1 Scroll Lock on 


Reserved (Initialize to 0000h) ee 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 


0000h Successful Operation 
| 8000h Device Busy, Request Refused 


Invalid Logical ID 


Invalid Function 
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Function: 0Ch — Set Keyboard LED Status 


Description 


This function generates a multistaged request that turns on or off the key- 
board Caps Lock, Scroll Lock, and/or Num Lock LEDs. 


mequestt Block Structure 


[roe eee 
—ae Baca Block Length bpO pn nEnpoRnenoSnEnEnno”nonennonESnncnnenenncennnooennenonnennEnoanncanonacss 


| o2h | 
| 06h _| 


unit 


06h Function (000Ch 
Reserved (initialize to 0000h | 
Reserved (initialize to 0000h) os 


Return Code ||_Return Code _ | | 


| Byte 


Time to wait before continuing | 
“11 request (microseconds) 


Program the Keyboard LED 
| Status Indicators 


Bits 7-3= 0 Reserved 

Bit2 = 1Caps Lock on 
Bit 1 = 1 Num Lock on 
Bit O = 1 Scroll Lock on 


Reserved (Initialize to 0000h) . 


TR 
— 


continued 
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Function: 0Ch — Set Keyboard LED Status, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 


all valid bits in the Return Code field to ensure proper performance. 


Not My Interrupt, Resume Stage after Interrupt 
8000h Device Busy, Request Refused 


B101th Keyboard Error 
The operating system should invoke function 05h Reset/in- 
itiallze Keyboard after a keyboard hardware error. 


co03h 


CO005h Invalid Keyboard Parameter 
FFFFh Return Code is Not Valid 
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Function: 0Dh — Set Typematic Rate and Delay 


Description 


This function generates a single-staged or discrete multistaged request that 
changes or sets the typematic rate and the keystroke delay for all keys on 
the keyboard. 


Typematic rate 


The typematic rate is the maximum number of make codes per second that 
the keyboard can support. The rate in characters per second can be set at 
any of 32 values, ranging from 2 to 30 characters per second. 


Keystroke delay 


The keystroke delay established by this function is the delay between the 
period of time that elapses between a keystroke and the scan code gener- 
ated by the key stroke being sent to the keyboard controller. This delay can 
be set at 250, 500, 750, or 1000 milliseconds. | 


- continued 
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Function: 0Dh — Set Typematic Rate and Delay, Continued 


Request Block Structure 


Fores] sie [mous 


| 02h | Word || Logical ID 

a 
| 06h | Word || Function (000Dh 

| 08h _| Word | 


al 
14h 


. Typematic Rate Setting 


Bits 7-5= Reserved 
(must be 0) 

Bits 4-O0= Rate setting in 
characters per second 
(values in binary) 


00000 = 30.0 10000 = 7.5 
00001 = 26.7 10001 =6.7 
00010 = 24.0 10010 = 6.0 
00011 = 21.8 10011 = 5.5 
00100 = 20.0 10100 = 5.0 
00101 = 18.5 10101 = 4.6 
00110 = 17.1 10110 = 4.3 
00111 = 16.0 10111 = 4.0 
01000 = 15.0 11000 = 3.7 
01001 = 13.3 11001 = 3.3 
01010 = 12.0 11010 = 3.0 
01011 = 10.9 11011 =2.7 
01100 = 10.0 11100 = 2.5 
01101 =9.2 11101 =2.3 
01110=8.6 11110 =2.1 
01111 =8.0 11111 = 2.0 


Typematic Delay Setting 


Bits 7-2 = Reserved 
(must be 0) 

Bits 1-0 = Delay value in 
milliseconds (values 


in binary) 
00 = 250 
01 = 500 
10 = 750 


11 = 1000 


Reserved (Initialize to 0000h) S 


continued 
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Function: 00h — Set Typematic Rate and Delay, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Gedo | Description 


0000h | Successful Operation | | 
| 000th Resume Stage after Interrupt | 
0002h Resume Stage after Time Delay 


| 0005h Not My Interrupt, Resume Stage after Interrupt | 
8000h Device Busy, Request Refused | 


[e00ah [Resend error 
[sr00h | Keyooard Controter Perpetaly Busy 
[sian [Resende 


| BOO1h Keyboard Error 
Keyboard Error 
The operating system should invoke function 05h Reset/In- 
 {tlalize Keyboard after a keyboard hardware error. 
C000h ~= | _ Invalid Logical ID ) 
Cooth Invalid Function | 
C003h Invalid Unit Number | 
C004h | Invalid Request Block Length 


C005h Invalid Keyboard Parameter | 
FFFFh Return Code is Not Valid 
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Function 0Eh — Read Keyboard Scan Code Mode 


Description 


This function generates a discrete multistaged request that reads the key- 
board scan code mode from the 8042 status port. 


What is a keyboard scan code mode? 


Each time a key is pressed, the keyboard hardware generates a keyboard 
make or break scan code. The keyboard hardware is capable of generating 
any of three sets of keyboard scan codes (Modes 1, 2, or 3). 


Keyboard scan codes are not understandable to the system. The firmware 
resident in the 8042 keyboard controller chip translates all Keyboard scan 

codes into system scan codes (i.e. codes that are understandable to the 

system). 


Function OEh and the Phoenix 8042 AK/MCF 


Systems equipped with the Phoenix 8042 Advanced Keyboard/Mouse Control- 
ler Firmware (AK/MCF) support keyboard scan code mode 2 exclusively. 
Function OEh returns the value corresponding to keyboard scan code mode 
2 only. 


continued 
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Function 0Eh — Read Keyboard Scan Code Mode, Continued 


nequest Block Structure 


Poorer : 
22h _|_ ord 
un | 

var 
meer ws 
: : 

Request (microseconds) 
Current Keyboard Scan Code 
0Oh = Reserved 


Oih = Set to 1 
02h = Set to 2 
03h = Set to 3 


pan O04h-Fh = Reserved 
oe Reserved (Initialize to 0000h) 


continued 
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Function 0Eh — Read Keyboard Scan Code Mode, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[o001h | Resume Stage after Inerupt SS 
[ooeah | Resume stage ater Tine Doky 


0005h Not My Interrupt, Resume Stage after Interrupt 
8000h Device Busy, Request Refused 


[sooo | Keyboard ContoterPerpotualy Busy 
[—s002n | Resenderor SSCS 
[so0sh [Keyboard Party Ever SSCC*d 
Hardware Time-out 

[si00h | Keyboard Controler Perpetualy Busy 
[—st0im | Keyboard Faled Reset 
[siaan [Resend eer 
| 9103h 
| 9t04h | 
| 9108h 


[Keyboard Party Ever SSSCSCSC~* 


Keyboard Error 
The operating system should invoke function 05h Reset/In- 
itiallze Keyboard after a keyboard hardware error. 


[—eo0en [vale Unt Number 


C005h Invalid Keyboard Parameter 


FFFFh Return Code is Not Valid 


continued 
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Function: 0Fh — Set Keyboard Scan Code Mode, Continued 


Description 


This function generates a multistaged request that sets the keyboard scan 
code mode. 


What is a keyboard scan code mode 


Each time a key is pressed, the keyboard hardware itself generates a key- 
board make or break scan code. The keyboard hardware is capable of 
generating any of three sets of keyboard scan codes (Modes 1, 2, or 3). 


Keyboard scan codes are not understandable to the system. The firmware 
resident in the 8042 keyboard controller chip translates all keyboard scan 

codes into system scan codes (i.e. codes that are understandable to the 

system). 


Function OFh and the Phoenix 8042 AK/MCF 


Systems equipped with the Phoenix 8042 Advanced Keyboard/Mouse Con- 
troller Firmware (AK/MCF) support keyboard scan code mode 2 exclusively. 
Function OFh returns the value corresponding to keyboard scan code mode 2 
only. 


continued 
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Function: 0Fh — Set Keyboard Scan Code Mode, Continued 


Request Block Structure 
| 00h | Word | Request Block Length 


Logical 1D 


| 02h 
Unit 


Time-out 


: Time to Wait Before Continuing 
= Request (microseconds) 


| Change Current Keyboard Scan 
Code 


00h = Reserved 
Oth = Set to 1 
O2h = Set to 2 
03h = Set to 3 


Word || Reserved (initialize to 0000h) — ||. 


continued 
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Function: OFh — Set Keyboard Scan Code Mode, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0000h Successfui Operation 
| 000th Resume Stage after Interrupt 


| 0002h | Resume Stage after Time Delay 
|} 0005h | Not My Interrupt, Resume Stage after Interrupt 


8000h Device Busy, Request Refused 
8003h Security Enabled, Keyboard Inhibited — Request Refused 


Keyboard Controller Perpetually Busy : 
| 9101h | Keyboard Failed Reset 


[esa [Resend ror 
BOOth Keyboard Error | 


Keyboard Error 
The operating system should invoke function 05h Reset/In- 
itialize Keyboard after a keyboard hardware error. 


9000h Keyboard Controller Perpetually Busy 


Co00h Invalid Logical ID 
Invalid Function 
C003h Invalid Unit Number | 


Co0th 
C004h invalid Request Block Length | | 


coosh | Invalid Input Parameter | 
| FFFFh Return Code is Not Valid 
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Function 10h — Write Command(s) to Keyboard Controller 


Description 


This function generates a discrete multistaged request that writes a com- 
mand and associated data from the system to the 8042 controller. The 
command consists of a single byte. The location and length of the command 
must be specified at function start-up. This function permits access to 8042 
RAM, keyboard self-tests, interface tests, and other 8042 functions that are 
otherwise not available in ABIOS. 


Changes to 8042 


The caller must not change the state of the 8042 in intermediate stages of a 
Mmultistaged request for this function. 


Input field considerations 


The Data String Length (offset 1Ch) must be initialized to a nonzero value. If 
the Data String Length field is initialized to OOh, then function 10h does not 
perform any action and sets the Return Code field to 0000h, Successful 
Operation. 


ABIOS keyboard command processing 


The first byte of the string passed to ABIOS is assumed to be the command 
byte and is sent to !/O port 0064h. All subsequent bytes are sent to |/O port 
O0061h. ABIOS issues a Return Code of 0001h, Resume Stage after Interrupt, 
between each byte sent. At this point, ABIOS does not respond to the key- 
board controller. It reads the 8042 status register, which indicates when 
commands have been accepted. Return Code Q000h is issued when all bytes 
have been read. 


continued 
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Function 10h — Write Command(s) to Keyboard Controller, 
Continued 


| System-to-8042 commands 


| READ THE 8042 COMMAND BYTE. 
This command instructs the 8042 to send the contents of location 
20h, the command byte, to the system. 


21h-3Fh READ THE 8042 RAM. 
This command instructs the 8042 to send the contents of the RAM 
location, defined by bits 5-0 of the command to the system. 


WRITE THE 8042 COMMAND BYTE. 
This command instructs the 8042 to write the data byte following the 
command to the location of the command byte (20h). 


61h-7Fh WRITE THE 8042 RAM. 
This command Instructs the 8042 to write the data byte following the 
command to the RAM location defined by bits 0-5 of the command. 
A4h TEST PASSWORD INSTALLED. 
| This command instructs the 8042 to check whether there is a pass- 
word currently installed. If there is no password, the contents of the 
first location where the password would be stored will be zero. If 
there is a password installed, FAh is placed in the 8042 output buffer, 
A6h ENABLE SECURITY. 
This command Instructs the 8042 to check the installed password 
against the incoming keystrokes for a match. 
A7vh DISABLE AUXILIARY DEVICE INTERFACE. 
This command instructs the 8042 to set bit 5 of the command byte. 
This disables the auxiliary device by driving the auxiliary clock low. 
AQh 
and data lines. The result of the test is placed in the output buffer as 
follows: 
00 — No error detected. | 
01 — Auxiliary device clock line is stuck low. 
02 — Auxillary device clock line is stuck high. 


If not, Fih is placed in the buffer. 
ENABLE AUXILIARY DEVICE INTERFACE. 
03 — Auxiliary device data line is stuck low. 
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LOAD SECURITY. 
This command instructs the 8042 to read password data from the 
8042 input buffer and store it until a null (0) is detected. The null is 
stored as the last byte of the password. 
This command instructs the 8042 to clear bit 5 of the command byte. 
This enables the auxiliary device by driving the auxiliary clock high. 
AUXILIARY INTERFACE TEST. | 
This command instructs the 8042 to test the auxiliary device clock 

04 — Auxiliary device data fine is stuck high. 


SELF TEST. , 
This command instructs the keyboard 8042 to perform internal diag- 


nostics tests. A 55h is placed in the output buffer if no errors are 
detected. 


continued 


Function 10h — Write Command(s) to Keyboard Controller, 
Continued 


System-to-8042 commands, cont’d 


Command Description 


ABh | KEYBOARD INTERFACE TEST. 
This command instructs the 8042 to test the keyboard clock and data 
lines. The result of the test is placed in the output buffer as follows: 


No error detected. 


Keyboard device clock line is stuck low. 
Keyboard device clock line Is stuck high. 
Keyboard device data line is stuck low. 

Keyboard device data line is stuck high. 


Reserved 


DISABLE KEYBOARD INTERFACE. 
This command Instructs the 8042 to set bit 4 of the command byte. 
- This disables the keyboard by driving the keyboard clock low. 
ENABLE KEYBOARD INTERFACE. 
This command instructs the 8042 to clear bit 4 of the command byte. 
This enables the keyboard by driving the keyboard clock line high. 


READ INPUT PORT. 
This command instructs the 8042 to read the 8042 input port (port 1) 
and place the data in the 8042 output buffer. | 


Cih POLL INPUT PORT LOW. 
This command Instructs the 8042 to continuously read input port 1 
bits 0-3 into the status register, bits 4-7, until IBF goes high, when 
the next command Is executed. 


C2h POLL INPUT PORT HIGH. 
This command instructs the 8042 to continuously read input port 1 

bits 4-7 Into the status register, bits 4-7, until IBF goes high, when 
the next command is executed. 


READ OUTPUT PORT. 
This command instructs the 8042 to read the 8042 output port (port 
2) and place the data In the 8042 output buffer. | 


WRITE OUTPUT PORT. | 
This command instructs the 8042 that the next byte of data received 
should be sent to the 8042 output port. 


A 
A 
A 


Ch 
Dh 
Eh 
COh 


WRITE KEYBOARD OUTPUT BUFFER. 

This command instructs the 8042 that the next byte of data received 

should be sent to the output buffer. The controller will generate an 

er enrupt to the system if the interrupt bit is enabled in the command 
yte. 


WRITE AUXILIARY DEVICE OUTPUT BUFFER. 
This command Instructs the 8042 that the next byte of data received 
should be sent to the output buffer. The 8042 will generate an inter- 
fel to the system if the interrupt bit is enabled in the command 

yte. 


continued 
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Function 10h — Write Command(s) to Keyboard Controller, 
Continued | 


System-to-8042 commands, cont’d 


WRITE TO AUXILIARY DEVICE. 
This command Instructs the 8042 that the next byte of data received 
should be transmitted to the auxillary device. 


READ TEST INPUTS. 
This command instructs the 8042 to read the 8042 TO and T1 Inputs 
and place them In the output buffer. Bit 0 represents TO and bit 1 

represents 11. 


PULSE OUTPUT PORT. : 
This command instructs the 8042 to pulse bits 0 through 3 of the out- 
put port (port 2) low for 6 microseconds. Bits 0 through 3 of the 
command indicate the bits to be pulsed. 


If the bit Is a 0 then the corresponding bit on port 2 should be pulsed. 
If the bit is a 1 then the corresponding bit should not be pulsed. 


Request Block Structure | 

| 00h | Word _ 
| 02h _ | Word | 
| 
| 06h _ | Word | 
| ReturnCode 


Time to wait before continuing 
request (microseconds) 


[14h | Word || Reserved (Initialize to 0000h) 
| 16h | DWord Pointer to the data area 
1Ch Byte Data String Length 


Note: No action occurs if this 
field is 0. 


continued 
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Function 10h — Write Command(s) to Keyboard Controller, 
Continued 


Return Codes 
This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Code Description 


0000h 
000th 


Successful Operation 

Resume Stage after Interrupt 

Resume Stage after Time Delay 

Not My Interrupt, Resume Stage after Interrupt 
8000h 
8003h 
9000h 
9002h 


Device Busy, Request Refused 
Security Enabled, Keyboard Inhibited — Request Refused 
Keyboard Controller Perpetually Busy 


Resend Error 
Keyboard Controller Perpetually Busy 
Keyboard Failed Reset 


9102h Resend Error 
BOOth Keyboard Error 
B1i01h Keyboard Error 


The operating system should invoke function 05h Reset/In- 
itialize Keyboard after a keyboard hardware error. 


Co00h 
Cooth 
C003h 
C004h 


Invalid Logical ID 

invalid Function 

Invalid Unit Number 

invalid Request Block Length 
Co005h | Invalid Keyboard Parameter 
FFFFh Return Code is Not Valid 
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Function 11h — Write Command(s) and Data to Keyboard 


Description 


This function generates a discrete multistaged request that writes a “list” of 
a command and data from the system to the keyboard hardware itself. The 
command/data list may consist of any combination of a command and data, 
however, only one command can be sent per request. The location and 
length of the command/data list must be specified at function startup. ABIOS 
delays between writing each byte. 


Receipt of ACK 


ABIOS expects an Acknowledge from the 8042 keyboard controller at I/O port 
0060h after each byte is received, but does not send the ACK byte to the 
caller. 


Changes to 8042 


The caller must not change the state of the 8042 in intermediate stages of a 
multistaged request for this function. 


ABIOS keyboard command processing 


The first byte of the string passed to ABIOS is assumed to be the command 
byte and is sent to I/O port O0060h. All subsequent bytes are also sent to I/O — 
port OO060h. ABIOS issues a Return Code of 0001h, Resume Stage after 
Interrupt, between each byte sent. From the I/O ports, each byte is sent to 
the keyboard controller. At this point, ABIOS does not respond to the key- 
board controller, since it reads the 8042 status register which indicates when 
commands have been accepted. Return Code O0000h is issued when all bytes 
have been read. 


Some commands from the system to the 8042 controller require that a data 
byte also be written to I/O port 64h. Function 11h does not support such 
commands. 


continued 
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Function 11h — Write Command(s) and Data to Keyboard, Continued 


Table of system-to-keyboard commands 


SET/RESET LED TOGGLE STATUS INDICATORS. 

The Num Lock, Caps Lock, and Scroll Lock LED indicators can be 
turned on or off by a command from the system. The EDh com- 
mand byte is written to port 0060h and the keyboard responds with 
FAh (ACK). The system then writes the option byte to port 0060h. 
A value of 1 means turn the LED on. The option byte takes the 
format below: 

Bit 7-3 = Reserved (must be 00000b) 

Bit2 = Caps Lock LED 

Bit 1 = Num Lock LED 

Bit O = Scroll Lock LED 


ECHO. 
The system uses this command to test the keyboard. The key- 
board issues an EEh (Echo) in reply to this command. 


INVALID COMMAND. 

The keyboard does not acknowledge this command. 

CHOOSE ALTERNATE SCAN CODE SET. 

The 8042 APCF supports scan code set 2 only. 

INVALID COMMAND. 
The keyboard does not acknowledge this command. 


READ KEYBOARD ID BYTES. 


The keyboard acknowledges the command and sends the two key- 
board ID bytes. 


SET TYPEMATIC REPEAT RATE AND DELAY PERIOD. 
The system may set typematic rate and delay. 


ENABLE. 
Commands the keyboard to clear its output buffer and begin 
scanning. 


DEFAULT DISABLE. 

Resets all conditions within the keyboard to their power-on default 
state and disables scanning. The keyboard responds with ACK, 
clears its output buffers, and waits for the next instruction from 
the system. 


SET DEFAULT 

Resets all conditions within the keyboard to their power-on default 
state and enables scanning. The keyboard responds with ACK and 
clears all output buffers. 


F7h-FDh RESERVED 


RESEND. 
If the system detects an error in transmission, it issues the resend 
command. The keyboard responds by sending the previous output. 


System issues this command to invoke the keyboard's internal 
self-test. 


continued 
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Function 11h — Write Command(s) and Data to Keyboard, Continued 


Request Block Structure 


a 


| 00h | Request Block Length | dhe 
| 02h _| Word |} Logical ID 
| 06h __ 


[Word 
| | Function (0011h) (st 
Reserved (initialize to 0000h) 
[oan 
Return Code 


Time to Wait Before Continuing 
Request (microseconds) | 


~ Reserved (Initialize to 0000h) 
Logical Pointer to the Data Area 


Data String Length 


Note: No action occurs if this 
field is 0. 


Reserved (Initialize to 0000h) = 


s wiols| 9 
2) slzlo| = 
a 1S ja; 8 

Q. a. 


continued 
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Function 11h — Write Command(s)/Data to Keyboard, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0000h Successful Operation 
Resume Stage after Interrupt 


| 0002zh Resume Stage after Time Delay 


| 000Sh Not My Interrupt, Resume Stage after Interrupt 
8000h Device Busy, Request Refused 


er eee eineconans 
[sich | Resend err SOSCSC—~—S 


BOOth Keyboard Error 
| B101h Keyboard Error | 

The operating system should invoke function 05h Reset/In- 
itialize™ Keyboard after a keyboard hardware error. 

Co00h Invaiid Logical ID 

Cooth Invalid Function 

CO003h Invalid Unit Number 

C004h Invalid Request Block Length 


C005h Invalid Keyboard Parameter 
FFFFh Return Code is Not Valid 
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Chapter 11 
ABIOS Video Service 


Overview 


Description 


The ABIOS Video Service provides provides |/O support for IBM PS/2- 
compatible video hardware, specifically, a video graphics array (VGA) 
adapter. VGA video is built into the motherboard of most PS/2 and 
compatible computers. 


The ABIOS Video Service provides !/O support for both color and mono- 
chrome analog video monitors. 


ABIOS Video Service provides a significant advantage in that most routines 
can be called by user programs regardless of the video mode being used 
(monochrome, CGA, EGA, or VGA). The ABIOS Video Service makes avail- 
able all the features and functions of the VGA BIOS. The Video Services 
determine the current display type and perform the necessary address 
translation. 


continued 
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Overview, Continued 


Somimaly of Video Service functions 


<A 
[ih | Return Coated IO Parameters 
em [Revered 
0m [ eas Bevce Parameters 
Teh Reseres 
Sa [i.e AER 


a Enhanced Load Text Mode Font | 
pth | Read Palette Register | 


Write Block of Color Registers 


In this chapter 
This chapter includes information about the following topics: 
a Hardware Environment 
» Video Modes 
« Mode/Monitor Support 
» ROM-Resident Fonts 
» Error Handling 
=» Video Service Functions 
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Hardware Environment 


Introduction 


The ABIOS Video Service supports IBM VGA-compatible hardware, including: 


a VGA-compatible chip or chip set that includes a: 

» CRT Controller 

=» sequencer 

# graphics controller, and an 

# attribute controller 

DAC chip — INMOS G171 or compatible DAC (digital-to—analog converter) 
video RAM — 256K of dynamic read/write RAM configured as four 64K 
maps 

monochrome or color direct drive analog monitor 

monochrome or color multiple sync frequency monitors 


VGA-compatible chip (or chip set) 


The VGA chip (or chip set) provides all CRT control signals. It consists of 
four components, summarized in the following table: 


CRT Controlier 


Sequencer Arbitrates system access to display RAM and fonts. The 
sequencer allows up to eight fonts with two fonts display- 
able at any one time. 

Graphics Controller | Handles read/write operation on four parallel bit planes. Out- 
puts data to Attribute Controller. 

Attribute Controller | 


Function 


Generates horizontal and vertical CRT sync timings, cursor 
and underline timings, video buffer addressing, and refresh 
addressing. 


Converts incoming text mode attribute data or graphics 
mode pixel data into 8-bit indices into the Digital-to—-Analog 
Converter (DAC) color registers (see below). 


For a complete description of VGA-compatible components, |/O ports, and 
registers, refer to the hardware documentation accompanying your particular 
VGA-compatible chip or chip set. 


continued 
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Hardware Environment, Continued 


Digital-to-—Analog Converter (DAC) 


The video DAC contains 256 individual color registers which can be accessed 
by the BIOS as either four 64-color registers or sixteen 16-color registers. 


Each DAC color register contains one 18-bit RGB analog value. Six bits of 
each register are allocated to each primary color. Thus, the color repre- 
sented in each DAC color register may be any of 256K possible colors 
(i.e. 25*6 = 256K). 


Video RAM 


The ABIOS video service requires at least 256K of read/write video RAM 
formatted into four banks (or maps) of 64K. 


To maintain compatibility, display memory for each of the MDA, CGA, and 
EGA-compatible modes is mapped exactly as it was in the original display 
adapter. The display memory organization for the new VGA modes is 
Outlined in this chapter under the Video Modes heading. 


Analog monitor support 


To display all modes, the Video Service requires either a monochrome or a 
color direct drive analog monitor with a 31.5 KHz horizontal scan frequency. 


The display’s vertical gain is adjusted automatically by the VGA-compatible 
circuitry. Thus, video modes with 350, 400, and 480 horizontal scan lines 
can be displayed without requiring manual adjustment. 


Multiscan monitor support 


In addition to 31.5 KHz direct drive analog monitors, the Video Service also 
supports multiscan rate monitors capable of operating in analog modes (e.g. 
NEC Multisync monitor). Monitors of this type require an adapter cable that 


matches the signal assignments and monitor ID circuitry of the DAC external 
video controller. | 
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Video Modes 


Introduction 


The ABIOS video service supports 17 video modes, providing backward 
compatibility with MDA (Monochrome Display Adapter), CGA (Color Graphics 
Adapter), and EGA (Enhanced Graphics Adapter) modes — as well as com- 
patibility with all new VGA modes. 


Table of video modes 


en [wn [om | Ss [on 3 [BS 
Res. Type Colors Scheme| Box Pgs. Start 

|0,1 | eGas | a20xa50 | Text | 16/256k | 4oxas | exi4 | 8 | B8000h | 
|0,1 | vaa+ | 360x400 | text | 16/256k | 40x25 | oxte | 8 | B8000h_ 
[2,3 | eaat | e4oxaso | text | te/asck | sox2s | axi4 | 8 | Ba000n | 
| 2,3! | vars | 720x400 | Text | 16/2s6k | 80x25 | oxi6 | 8 | B8000n_ 
[4,5 haa 
6 


| caa_| 320x200 | Graphics | _4/256x_| 4oxes | ax | 1 | B8000h | 
| CGA | 640x200 [Graphics | 2/256K | 80x25 | 6x8 _| 


[ean | 640x200 [Graphice | 16/256 | 20x25 | exe 


indicates power-on default mode 

3! = color monitor Is attached, 
7! = monochrome monitor is attached. 

“*” Indicates that scan lines must be specified before mode set. (See 

AH = 12h BL = 30h Select Scan Line for Alphanumeric Codes for details.) 


indicates default mode 


F A0000h 


continued 
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Video Modes, Continued 


Video mode facts 


310 


All modes can be displayed on color or monochrome 
All video modes can be displayed on either color or monochrome 
monitors. 


MDA, CGA, and EGA modes are emulated 
To insure compatibility with older software, the ABIOS Video Service 
emulates all MDA, CGA, and EGA modes. 


Modes 00h, 02h, 04h = Modes Oth, 03h, 05h 

On the CGA adapter, modes OOh, 02h, and 04h have color burst turned 
off, and modes O1h, 03h, and O5h have color burst turned on. The ABIOS 
video service does not support color burst; modes OOh, 02h, and 04h are 
identical to modes Oth, 03h, and 05h, respectively. 


Text mode resolution determines default font/text scheme 

In text modes, the number of scan lines to display must be specified via 
function 05h Set Video Mode. Setting text mode scan lines determines 
both the default ROM-resident font ABIOS will load and the column—by-row 
text scheme in which the font will be displayed. 


Text mode default font and text scheme can be overridden 

ABIOS Video Service function OFh Load Text Mode Font allows the caller 
to override the default font loaded when a text mode is requested. Func- 
tion 10h Enhanced Load Text Mode Font allows the caller to override both 
the default font and column-by-row text scheme associated with a given 
text mode. 


Color modes are programmable 

Unless specified otherwise, the default colors associated with a given 
video mode are programmed by ABIOS at mode set. ABIOS Video Service 
functions 11h-16h can be used to override the default colors associated 
with any given color mode. See the Programming Colors section in this 
chapter for more information. 


200 scan-line modes are double-scanned 
Each line of video is painted on the screen twice, one beneath the other, 
before the next new scan line is painted. | 


No cursor in graphics modes 
A cursor is not displayed in graphics modes. 
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Mode/Monitor Support 


Introduction 
Both monochrome and color 31.5 KHz direct drive analog monitors, as well 
as multiscan monitors, can display all of the VGA video modes. 


When a monochrome monitor is attached, colors are displayed as shades of 
gray. When a color monitor is attached, gray scale summing must be explic- 
itly enabled or disabled via function 05h Set Video Mode. 


Some mode/monitor facts 


Se ee 


a monochrome analog 
monitor is attached... 


colors are displayed as shades of gray, with the maxi- 
mum number of shades equal to the maximum number 
of colors displayable in the respective mode. In mode 

OEh, for example, 16 shades of gray can be displayed. 


Mode 13h is an exception to this rule. Only 64 (and not 
256) shades of gray can be displayed in mode 13h. 


a color analog monitor is the colors displayed are selected from a BIOS initialized 
attached..... | palette of 64 color registers. The number of colors dis- 
played in each mode is listed under the Video Mode 
heading in this chapter. In mode OEh, for example, 16 
different colors can be displayed. 


The BIOS initializes the 64 colors In this palette to analog 
equivalents of the 64-color digital EGA palette. The re- 
maining 192 color registers are undefined. 


Mode 13h is an.exception to this rule. Mode 13h is capa- 
ble of displaying all 256 colors stored in the DAC. The 
BIOS initializes these colors to IBM compatible defaults 
at mode set. 


a 200 scan line mode is se- 


all 200 scan line modes are double-scanned. That is, 
lected.... 


each horizontal line is scanned twice, for a total of 400 
scan lines. This is true for both color and monochrome 
analog monitors. 


power-on default video 


the default power on mode is mode 3+ (720x400, 
modes are in effect .... 


16-color) when a color analog monitor is attached, or 


mode 7+ (720x400, monochrome) is the default power- 
on mode when a monochrome analog monitor is 
attached. 


continued 
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Mode/Monitor Support, Continued 


Palette register/DAC relationship 


The Attribute Controller component of the VGA hardware contains an internal 
Palette Register. The Palette Register is composed of sixteen 8-bit registers. 
The value contained in each palette register is combined with other Attribute 
Controller information to create an 8-bit index into the DAC. 


The video DAC contains 256 individual color registers. Each DAC color 
register contains one 18-bit RGB analog value. Six bits of each register are 
allocated to each primary color. Thus, the color represented in each DAC 
color register may be any of 256K possible colors (i.e. 2°** = 256K). 


ABIOS initializes the Palette Registers and the DAC Color Registers upon 
each mode set: 


EGA and DAC 

16-color VGA The ABIOS initializes access to the 256 DAC color registers in 
blocks, or pages, of 64 colors each. The first 64 color page is 
initialized to analog equivalents of the 64 EGA colors. The 
remaining 192 colors remain undefined. 


Attribute Controller 

To maintain color compatibility with existing EGA software, the 
BIOS initializes the Attribute Controller to the 16 commonly 
accepted default EGA colors. 


DAC 

The ABIOS initializes access to the 256 DAC color registers as four 
blocks of 64 colors each in CGA modes. The first 64 color block is 
initialized as four 16 color subblocks. Each of these 16 color sub- 
blocks is initialized to the 16 colors displayable in CGA mode. The 
remaining 192 DAC registers are undefined. 


- Attribute Controller 
To maintain color compatibility with existing CGA software, the 
ABIOS initializes the Attribute Controller to the 16 color CGA pal- 
ette. When applications software requests a CGA color, the Attrib- 
ute Controller maps the requests through to its analog equivalent in 
the DAC controller. 
DAC 
The ABIOS initializes all 256 color registers to their IBM PS/2 
default equivalents. 


Attribute Controiler 

The attribute controller receives 8- bit color values directly from 
application programs. It maps those values directly into the DAC 
color registers. 


continued 
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Mode/Monitor Support, Continued 


Overriding default color values 


ABIOS Video Service functions 11h-16h provide ways of overriding default 
Palette Register values. For more information, see the descriptions of these 
functions later in this chapter. 


ROM-Resident Fonts 


ROM-resident fonts 


The BIOS contains three ROM BlOS-resident character generators (fonts): 
=» 8x8 dot 
» 8x14 dot 
» 8x16 dot 


The BIOS is also capable of generating a 9x16 dot font in 400 line text 
modes. The BIOS generates this 9x16 font by running the 8x16 Character set 
through a ROM-resident table of corrections. 


continued 
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ROM-Resident Fonts, Continued 


Default fonts are loaded during mode set 


The default font associated with a given video mode is loaded by function 
O5h Set Video Mode. Which default font is loaded is directly related to the 
resolution ie sei by the mode requested. 


if the resolution is.. Then the default font is.. 


ee a 


Text modes and character blocks 


In text modes, the ASCIi character number is written to video memory map 
0; the corresponding attribute byte is written to memory map 1. Memory 
map 2 is used for storing font data. 


Each font occupies one 8K block, making for a total of 8 possible fonts. 
Character block numbers are zero—based. Character block 0 contains the 
first 8K font; character block 1 contains the second 8K character block; and 
so on through character block 7. 


The maximum number of characters associated with any one font is 100h 
(i.e. 256 characters). The video hardware is capable of displaying characters 
selected from up to two character blocks (i.e. up to 512 characters). 


Overriding default fonts 


ABIOS Video Service functions OFh Load Text Mode Font and function 10h 
Enhanced Load Text Mode Font provide a way to load nondefault or user- 
defined fonts into character blocks for display in a given text mode. 
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Error Handling 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


lf Bit 15 of the Return Code field is set, the Video Service function requested 
has an error. The caller’s Return Code handler routine should then test Bits 
14, 13, 12, and 8 to determine the class of error that has occurred. The 
return code handler routine should then test the remaining bits to determine 
the precise nature of the error. 
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Function: 00h — Default Interrupt Handler 


Description 


This single-staged function handles unexpected hardware interrupts by reset- 
ting the interrupting condition at the device level. 


In the ABIOS Video Service, function 0Oh resets the appropriate video hard- 
ware registers. 


When to invoke 


This function is only invoked if a given Logical ID has no outstanding Request 
Blocks waiting for an interrupt. 


Request Block Structure 


| 00h | Word _ Request Block Length = 
Logical 1D 


Word : S 
: lee Te 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


"1" 

0000h Successful | Successful Operation ss 
oon Not My Interrupt, Resume Stage after Interrupt 

Cco00h _ Invalid Logical ID 

Cooth Invalid Function 


C003h Invalid Unit Number | 
C004h Invalid Request Block Length 


FFFFh Return Code Field Not Valid | 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns the parameters for the 
specified Logical ID. 


Request Block Structure 


| 02h | Word || Logical IDO 

[Unit 

6h_| Word || Function (0001h) 
Count of Units 
Logical ID flags 


Bits 15-4 = Reserved 

Bit 3 = 0 No overlap across 
units 

= 1 Overlap across units 

supported 

Bit 2 = 0 Reserved 

Bits 1-O = Transfer Data Pointer 
Mode 
00 = No Pointers 

Required 


14h | Word |} 
Request Block Length (for other 
=A) functions 
Secondary Device ID 
“11 Revision Level 


1Eh Reserved (initialize to 0000h) Q 


1ih te 
12h ord 


O;1OIO jlo !|o 
m © 
to} © 
elxiazizin 
oj;QO;/0O (oOo 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


[o00sh | Not My interrupt, Resume Stage afer irre 


FFFFh Return Code Field Not Valid 


Function: 02h — Reserved 
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Function: 03h — Read Device Parameters 


Description 


This single—staged function returns parameter data concerning the current 
video state. It also returns buffer size information that must be referenced 
before invoking Function OBh Return ROM Fonts Information and Function OCh 
Save Video Environment. 


Video state parameters 


The video parameters returned by function 03h include: 


current video mode, 

number of scan lines associated with mode, 
monitor type (color or monochrome), 
character height, and 

character blocks specifiers. 


Character block specifier field 


When the current video mode is a text mode, the Character Block Specifier 


field at offset 24h in the Request Block identifies which two character blocks 
are being used. 


Bits 11-8 hold the binary value (O0O0b-111b) of character block A, which 
contains the first displayable character set. Bits 3-0 hold the binary value of 
character block B, which contains the second displayable character set. The 
remaining bits in this field are reserved. 


continued 
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Function: 03h — Read Device Parameters, Continued 


Interpreting the character block specifier field 


320 


The values returned in the function 03h Request Block Character Block 
Specifier field are interpreted as described in the table below: 


When the value of character block Two character sets are available for dis- 
specifier A is different from charac- play. 


ter block specifier B = Bit 3 of the attribute byte identifies which 
character block is to be displayed: 


1 = Use character block selector A 
0 = Use character block selector B 


When the value In character block 
specifier A is equal to the value in 
character block specifier B 


» One character set is available for display. 


e Bit 3 of the attribute byte determines the 
foreground intensity of the character dis- 
played: ! 


1 = Foreground intensity on 
0 = Foreground intensity off 


If the mode returned is a graphics mode, the value returned in the Character 
Block Specifier field is undefined. 


continued 
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Function: 03h — Read Device Parameters, Continued 


Buffer size parameters 


Function 03h also returns buffer size information applicable to the two Video 
Service functions listed below: 


= Buffer size: Function OBh Return ROM Fonts Information 
Function OBh Return ROM Fonts Information outputs information concerning 
each of the ROM fonts to a buffer specified on input. The value returned 
by function 03h at Request Block offset 2Ah provides the size of the 
buffer required by function OBh. 
Function 03h must always be invoked before function OBh can be exe- 
cuted successfully. For more information on Function OBh, see the de- 
scription of this function later in this chapter. 


= Buffer size: Function 0Ch Save Video Environment 
Function OCh Save Video Environment outputs the requested aspects of 
the current video state to a buffer specified on input. The values returned 
by function 03h at Request Block offsets 2Eh, 30h, 32h, and 34h are 
referenced by function OCh when determining the buffer size it will re- 
quire. 
Function 03h must always be invoked before function OCh can be exe- 
cuted successfully. For more information on Function OCh, see the de- 
scription of this function later in this chapter. 


continued 
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Function: 03h — Read Device Parameters, Continued 


Request Block Structure 


[oreo] sie [weed 


oon | Word aoa onooaegao one oanaoRenp aaa oRenenERanaREEanERRnoaRERnaREacRooNOoRRORAREE 
| 02h_| Word _| 

| 04h | Word 
| 06h | Word | 
| 08h_| Word _ 
: Scan lines per screen 


00h = 200 lines 
Oih = 350 lines 
02h = 400 lines 
03h = 480 lines 
04h-OFFh = Reserved 


Video Mode 


Type of monitor attached 


Bits 15-1 = Reserved 

Bit 0 = Color or monochrome 
: 0 = Color 

1 = Monochrome 


Character height (bytes/character) 


Character block specifier 
(Modes 0, 1, 2, 3, or 7 only) 


Bits 15-12 = Reserved 

Bits 11-8 = Character block 
select A 

Bits 7-4 = Reserved 

Bits 3-0 = Character block 

select B 


Size of save/restore buffer header 
bytes 

Size of save/restore hardware 
states (bytes) | 

Size of save/restore Device Block | 
state (bytes) 

Size of save/restore Digital-to- 
Analog Converter state (bytes) 


continued 
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Function: 03h — Read Device Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


FFFFh Return Code Field Not Valid 


Function: 04h — Reserved 
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Function: 05h — Set Video Mode 


Description 


This single—staged function initializes the video hardware to the requested 
mode. | 


Table of video modes 


| | Max. Char. | Max.| Buff. 
| Mode Res. | Type Colors Scheme| Box Pgs. Start | 


| 0,1 | cGa* | 320x200 | Text | 16/256 | 40x25 | 8x8 | 8 | B8000h | 


|o.1 | eaas | 320x350 | text | 16/256 | 40x25 | oxta | 8 | Ba000h 
0,1 | vars | 360x400 | Text | t6/2sex_| 40x25 | oxt6 | 8 | B8000h_ 
| 2.3 | caat | e4oxz00 | Text | 16/256k | sox25 | axe | 8 | B8000h_ 
| 2,3 | Eaas | e4ox350| Text | 16/256K | soxes | ax14 | 6 | B8000h | 
2,31 | vaas | 720x400 | Text | 16/256K | 80x25 | oxt6 | 8 | B8000h_ 
| 4.5 | aa | 320x200 |Graphics | _a/2sek | 40x25 | 8x8 | 1 | B8000n 
| 8 | CGA | 640x200 [Graphics | _2/256k | 0x25 | ax8 | 1 | B8000h_ 
Text_| MDA Mono | 80x25 _| x14 | 8 | 80000h_ 
|_7!_| vaas | 720x400 | Text_| VGA Mono | 80x25 | oxi6 | 8 | B0000h | 
| BD | EGA | 320x200 |Graphics | 16/256 | 40x25 | ax8_| 8 | A0000n_ 
| E | EGA | 640x200 [Graphics |_16/256K_| 0x25 | axa | 4 | A0000h_ 
| F | EGA | 640x350 |Graphics|_Mono__| 80x26 | axi4 | 2 | A0000n_ 
| 10 | EGA | 640x350 | Graphics | 16/256K_| 80x25 | axia | 2 | Aa0o00n | 
| 11 | vaa | 640x480 |Graphics| 2/256 | 80x30 | axie | 1 | aoooon | 
| 12 | var | 640x480 | Graphics | 16/256K | 80x30 | axie | 1 _ 
| 13 | vaa_| 320x200 | Graphics | 256/256 | 4oxes | axe | 1 _ 


indicates power-on default mode 
3! = color monitor is attached, 
7! = monochrome monitor is attached. 


indicates that scan lines must be specified before mode set. (See 
AH = 12h BL = 30h Select Scan Line for Alphanumeric Codes for details. ) 


Indicates default mode 


continued 
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Function: 05h — Set Video Mode, Continued 


Video mode facts 


All modes can be displayed in color and monochrome 


All 17 video modes can be displayed on either color or monochrome 
monitors. 


MDA, CGA, and EGA modes are emulated 


To insure compatibility with older software, the ABIOS Video Service 
emulates all MDA, CGA, and EGA modes. 


Modes 00h, 02h, 04h = Modes Oth, 03h, 05h 

On the CGA adapter, modes 00h, 02h, and 04h have color burst turned 
off, and modes Oth, 03h, and O5h have color burst turned on. The ABIOS 
video service does not support color burst; modes OOh, 02h, and O4h are 
identical to modes O1h, 03h, and O5h, respectively. 


Text mode resolution determines default font/text scheme 

In text modes, the number of scan lines to display must be specified via 
function 05h Set Video Mode. Setting text mode scan lines determines 
both the default ROM-resident font ABIOS will load and the column-by-row 
text scheme in which the font will be displayed. 


Text mode default font and text scheme can be overridden 

ABIOS Video Service function OFh Load Text Mode Font allows the caller 
to override the default font loaded when a text mode is requested. Func- 
tion 10h Enhanced Load Text Mode Font allows the caller to override the 
default font and the column-by-row text scheme associated with a text 
mode. 


Color modes are programmable 


The default colors associated with a given video mode are programmed 
by ABIOS at mode set. ABIOS Video Service functions 11h-16h can be 
used to override the default colors associated with any color mode. See 
the Programming Colors section in this chapter for more information. 


200 scan-line modes are double-scanned 


Each line of video is painted on the screen twice, one beneath the other, 
before the next new scan line is painted. 


continued 
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Function: 05h — Set Video Mode, Continued 


Video mode facts, cont’d 


= No dots or characters written to screen by ABIOS 


ABIOS does not actually write dots or characters to video RAM so that 
they appear on the screen. The caller and/or other programs must do 
this. 


= No cursor in graphics modes | 
A cursor is not displayed in graphics modes. 


Function 05h input field considerations 


The Video Mode field (offset 1Eh) must be defined to a valid video mode 
number on entry into function 05h. The entry values of the remaining input 
fields depends on the monitor attached and the mode being requested 


Device Control Flag field (offset 1Ah) 


Located at offset 1Ah in the function 05n Request Block, the Device Control 
Flag contains three flags. The Device Control Flag field must always be 
defined upon entry into function O5h. 


= Bit 2 — Gray scale summing flag 


When a monochrome monitor is attached, gray scale summing is handled 
automatically by the video hardware. When a color monitor is attached, 
gray scale summing is enabled or disabled by setting this bit. 


# Bit 1 — Initialize DAC to default values flag 


The video DAC can be initialized to IBM-compatible default values upon 
each mode set. Bit 1 enables (on) or disables (on) this feature of the 
ABIOS Video Service. 


a Bit 0 — Clear video buffer flag 
Video buffer memory can be cleared upon mode set. This clears the 
video screen. Bit 0 enables (on) or disables (off) this feature. 


continued 
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Function: 05h — Set Video Mode, Continued 


Text mode scan lines (offset 1Ch) 


The number of scan lines must be defined each time a text mode (modes 
OOh, Oth, 02h, 03h, O7h) is requested. Besides indicating the number of 
scan lines to display, the value in this field determines which ROM-resident 
font the requested text mode will use. 


The PS/2 BIOS contains three ROM BlOS-resident fonts: 

=» 8x8 dot, used in 200 scan-line text and graphics modes 
=» 8x14 dot, used in 350 scan-line text and graphics modes 
» 8x16 dot, used in 480 scan-line graphics modes 


When 400 scan lines are indicated in the Text Mode Scan Lines field, the 
BIOS generates a 9x16 dot font. Because there is no ROM-resident 9x16 

font, the BIOS generates the 9x16 font by running the 8x16 font through a 
ROM-resident table of corrections. 


Note: This field is not defined for graphics modes. 


Character block to load (offset 26h) 


In text modes, the ASCII character number is written to video memory map 
QO; the corresponding attribute byte is written to memory map 1. Memory 
map 2 is divided into eight 8K character blocks. Each character block may 
contain one text mode character font. Character block numbers are zero- 
based. 


Bits O-7 of the Character Block to Load field define which character blocks 
will be loaded with the defau/t font associated with the text mode being 
requested. Setting Bit 0 to 1 instructs ABIOS to load the default font into 
Character Block 0. Setting Bit 0 to 0 tells ABIOS to preserve the present 
contents of Character Block 0. Setting Bit 1 to 1 instructs ABIOS to load the 
default font into Character Block 1, and so on. 


If all eight bits of the Character Block to Load field are set to zero, then 
ABIOS does not load the default font associated with the text mode re- 
quested. Setting all bits' to one causes ABIOS to load the default font into 
each Character Block. 
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Function: 05h — Set Video Mode, Continued 


Overriding default fonts 


ABIOS Video Service functions OFh Load Text Mode Font and function 10h 
Enhanced Load Text Mode Font provide a way to load nondefault or user- 
defined fonts into character blocks for display in a given text mode. 


Character Block to Select (offset 24h) 


In text modes, the video hardware is capable of displaying characters se- 
lected from up to two character blocks. The maximum number of characters 
associated with any one font is 256; therefore up to 512 characters can be 
displayed. 


When the current video mode is a text mode, the Character Block Specifier 


field identifies which two character blocks are being used. 


Bits 11-8 hold the binary value (OOOb-111b) of character block A, which 
contains the first displayable character set. Bits 3-0 hold the binary value of 
character block B, which contains the second displayable character set. The 
remaining bits in this field are reserved. 


When the value of character block » Two character sets are available for dis- 
specifier A is different from charac- play. 


ter block specifier B » Bit 3 of the attribute byte identifies which 
character block is to be displayed: 


1 = Use character block selector A 
0 = Use character block selector B 


When the value in character block » One character set is available for display. 


specifier A is equal to the value in = 
character block specifier B Bit 3 of the attribute byte determines the 


foreground intensity of the character dis- 
_ played: 
1 = Foreground intensity on 
0 = Foreground intensity off 


Function OEh Select Character Generator Block can be used to set the 
Character Block Specifier field independently from function O5h. 
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Function: 05h — Set Video Mode, Continued 


Request block structure 


| o6h_| Word _| 
| 08h_| Word _ 
OAh_| Word 


Device Control Flags 


Bits 15-3 = Reserved 

Bit 2 = Gray Scale Summing 
0 Disabled 
1 Enabled 

= Initialize DAC to 
ha values 


Bit 1 
No 
1 Yes 
= Clear video buffer 
No 
1 Yes | 
1Ch Text Mode Scan Lines 
00h = 200 lines 
(modes hex 0,1,2,3) 
Oih = 350 lines 
(modes hex 0,1,2,3,7) 
02h = 400 lines 
(modes hex 0,1,2,3,7) 
O3h-FFh = Reserved 
Video Mode 
Character Block to Display 
(modes hex 0,1,2,3,7) 
Bits 15-12 = Reserved 
Bits 11-8 Character Block A 
Bits 7-4 Reserved 
Bits 3-0 = Character block B 
Character block to load with de- 
fault ROM font (modes hex 
0,1,2,3,7) 
Bit n = Block n flag 
0 = Do not load font 
1 = Load default font 
Word Reserved (Initialize to 0000h) 
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Return Code 


continued 
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Function: 05h — Set Video Mode, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


FFFFh | Return Code Field Not Valid | 


Functions: 06h - OAh — Reserved 
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Function: 0OBh — Return ROM Fonts Information 


Description 


This single-staged function outputs information concerning each ROM- 
resident font to a ROM Font buffer area specified on function entry. 


How to determine buffer size 


Function 03h Read Device Parameters returns the size of the buffer required 
by the Return ROM Fonts Information function. Function 03h returns this 
value to offset 2Ah of the function 03h Request Block. 


Before function OBh can be issued, function 03h must always be invoked, to 
determine the proper buffer size. 


Buffer format 


Each entry into the ROM Font Information buffer occupies 12 bytes. The 
format of each font entry is defined in the table below: 


a 


Character size: number of columns 
Character size: number of rows 
O1h = Partial font 


Byte Total/Partial font, where: 
02h = FFh = Reserved 


h = total font 
| Byte Partial Font | | 
If a partial font is indicated in the byte above, this field tells 
which default font that partial font is drawn from. 


continued 
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Function: 0Bh — Return ROM Fonts Information, Continued 


Request Block Structure 


fore] sue [mee ome 


| 00h | Word _ | 
| 
| 04h | Word _ , 
| 08h | Word : 
e 
ar : 

ROM font information : 


[16h | Word || Reserved (initialize to 0000h) 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


FFFFh Return Code Field Not Valid 
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Function: 0Ch — Save Video Environment 


Description 


This single-staged function stores any of three video states to a buffer 
specified upon function entry. The three states are: 

=» Hardware state 

= Device Block state 

» Digital-to—Analog Converter (DAC) state 


Buffer size values are returned by function 03h 


The values returned by function 03h at Request Block offsets 2Eh, 30h, 32h, 
and 34h must be referenced in order to determine the buffer size to specify 
upon entry into function OCh. 


Description 


| Eh | Size of Save Environment buffer header 
| oh Buffer size required to save hardware state 


Buffer size required to save Device Block state 
Buffer size required to save DAC state 


To insure a proper buffer size is calculated, function 03h must always be 
issued before function OCh can be executed successfully. 


Calculating video environment buffer size 


The caller may elect to save any or all three video states. 


The size of the save environment buffer that must be specified on entry into 
function OCh is calculated as follows: 


Buffer header size + Buffer size of each state to be saved. — 


continued 
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Function: 0Ch — Save Video Environment, Continued 


Request Block Structure 


| 00h | Word | Request Block Length es 
| 02h | Word | Logical ID 


OAh L . 
| ReturnCode 


Reserved (Initialize to 0000h) | 


Pointer to environment save 
area 


Reserved (Initialize to 0000h) | 


Video states to be saved 


Bits 15-3 = Reserved (set to 0) 
Bit 2 = DAC state 
1 = Save state 
Bit 1 = Device Block state 
1 = Save state 
Bit 0 = Hardware state 
1 = Save state 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


Description 


0000h Successful Operation 7 “ie 


[cootm | vata Funeton 


FFFFh Return Code Field Not Valid 
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Function: 0Dh — Restore Video Environment 


Description 


This single—staged function restores the video environment located at the 
buffer area pointed to on function entry. 


For more information on the structure and contents of the video environment 
buffer, see “Function: OCh — Save Video Environment.” 


Request Block Structure 


| Return Code 


|| Pointer to the video environment |] 
to be restored : 


Reserved (Initialize to 0000h) 


Device control flag 


Bits 15-1 = Reserved 

Bit 0 = Clear video buffer 
0 =No | 
1 = Yes 


Video states to be restored 


|| Bits 15-3 = Reserved (set to 0) 
| Bit 2 = DAC state 
1 = Restore state 
Bit 1 = Device Block state 
1 = Restore state 
Bit 0 = Hardware state 
1 = Restore state 
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Function: ODh — Restore Video Environment, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


0000h 
<< 


[coos [inate Request Block torah —SSCSC~* 
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Function: OEh — Select Character Generator Block 


Description 


This single-staged function allows the caller, when in text modes, to select 
either of two character blocks. 


The maximum number of characters associated with any one character block 
is 256; therefore up to 512 characters can be displayed. 


When the current video mode is a text mode, the Character Block Specifier 
field identifies which two character blocks are being used. 


Bits 11-8 hold the binary value (OQOOb-111b) of character block A, which 
contains the first displayable character set. Bits 3-0 hold the binary value of 
character block B, which contains the second displayable character set. The 
remaining bits in this field are reserved. 


When the value of character block # Two character sets are available for dis- 
specifier A is different from charac- play. 


ter block specifier B « Bit 3 of the attribute byte identifies which 
character block is to be displayed: 


1 = Use character block selector A 
0 = Use character block selector B 


When the value in character block » One character set is available for display. 


specifier A is equal to the value in 
character block specifier B # Bit 3 of the attribute byte determines the 


foreground intensity of the character dis- 


played: 
1 = Foreground intensity on 
0 = Foreground intensity off 


Function 05h Set Video Mode can also be used to set the Character Block 
Specifier field. 


continued 
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Function: 0Eh — Select Character Generator Block, Continued 


Request Block Structure 


| 02h | Word _ 

| 04h _| Word _| 
| 06h | Word _ 
| 08h | Word _ 
|_0Ch_| Word | 
| OEh | Word |i. ee s 
| 16h_| Word _| 


Pt Character Block to Display 


Bits 15-12 = Reserved 
Return Codes 


Bits 11-8 = Character block A 
Bits 7-4 = Reserved 
Bits.3-0 = Character block B 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


Description 


Successful Operation 


Invalid Logical ID 


Invalid Function 


Invalid Unit Number 


C004h invalid Request Block Length 
Co05h Invalid Video Parameter 
FFFFh Return Code Field Not Valid 
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Function: 0Fh — Load Text Mode Font 


Description 


This single-staged function loads the font indicated on function entry into the 
specified Character Block in Memory Map 2. 


Scan lines per character, number of character rows, buffer length, and 
cursor size are not recalculated by this function. The font loaded here must 
occupy the defau/t character box size associated with the text mode in 
effect. 


When to use function OFh 


When in text mode, use function OFh to load a nondefault or user-defined 
font. For best results, insure that the bytes—per—character of the font being 
loaded is equal to the bytes—per-character of the default font. 


Function OFh input field considerations 


When a ROM-resident font is loaded, the character height is Known and the 
full 100h character set is loaded. Therefore, the caller need not specify the 
Count of Characters, Character Offset, or Character Height fields on function 
entry. 


When a user-defined font is loaded, all input fields must be specified on 
function entry. 


continued 
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Function: 0Fh — Load Text Mode Font, Continued 


Request Block Structure 


[oan | Word |[ Logical iD 
| 04m | Word |{ unit 
[06h | Word || Function (000Fh) 
| osh_| Word |{ Reserved (initialize to 0000h) | 
| An | Word || Reserved (initialize to0000h) fT 


Reserved (Initialize to 0000h) 3 


12h Pointer to the user font iT 
Reserved (Initialize to 0000h) : 


Word Count of characters | : 
Byte Valid values = O1h to 100h 


hal 
Font Type to Load 
00h = User-defined 
Oth = 8x8 ROM font : 
02h = 8x14 ROM font 
|] Osh = 8x16 ROM font : 
O04h-FFh_ = Reserved 2 
Word Character Height : 
(bytes/character) | 
| 28h | Word _ 


Character Block to Load 


0O0h-07h = Valid load values 
O8h-FFFFh = Reserved 


Character Offset : s 
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Function: OFh — Load Text Mode Font, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


0000h 


Successful Operation 

When a user-defined font is loaded, the Count of Charac- 
ters field must not be zero. If set to zero, no font is loaded 
and function OFh returns with Return Code 0000h Success- 
ful Operation. 


Coooh Invalid Logical ID 
Cootih Invalid Function 


C003h Invalid Unit Number 
C004h Invalid Request Block Length 


C005h 


FFFFh 
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Invalid Video Parameter 

When a user-defined font is loaded, the Count of Charac- 
ters and the Character offset fields must not exceed the 
maximum numbers of characters per character set (700h 
characters). |lf greater than 100h, function OFh returns with 
a Return Code field of C005h Invalid Video Parameter. 


Return Code Field Not Valid 
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Function: 10h — Enhanced Load Text Mode Font 


Description 


This single-staged function loads the font indicated on function entry into the 
specified Character Block in Memory Map 2. The font loaded here need not 
occupy the defau/t character box size associated with the text mode in 
effect. | 


Scan lines per character, number of character rows, buffer length, and 
cursor size are recalculated by this function. 


When to use function 10h 


Use function 10h to load a font that has a different box size than the default 
font associated with the current text mode. Cursor size and number of rows 
on screen will be recalculated automatically. 


For example, the default font associated with mode 07h (720x400, VGA text 
mode) is 9x16. The default text scheme is 80 columns by 25 rows. 


Since function 10h recalculates scan lines per character, number of charac- 
ter rows, buffer length, and cursor size, loading the ROM-resident 8x8 font 
in this mode yields a screen that displays 80 columns by 50 rows, with a 

_ properly scaled cursor. 


Function OFh input field considerations 


When a ROM-resident font is loaded, the character height is known and the 
full 100h character set is loaded. Therefore, the caller need not specify the 
Count of Characters, Character Offset, or Character Height fields on function 
entry. | 


When a user-defined font is loaded, all input fields must be specified on 
function entry. | : 


continued 
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Function: 10h — Enhanced Load Text Mode Font, Continued 


Request Block Structure 


| 02h | Word | : 
| 06h | Word _ : 


Return Goce 
[10h | Word || Reserved (Initialize to 0000h) _||. 


| 12h | DWord || Pointer to the user font | 
[16h | Word || Reserved (Initialize to 0000h) : 


iad fina Count ae | characters 

ae | values = 01h-100h 

Byte Font Type to Load 
00h = User-defined 
Oth = 8x8 ROM font 
02h = 8x14 ROM font 
03h = 8x16 ROM font 
O4h-FFh = Reserved : 

ae Character Height : 
(bytes/character) : 


Ret Character Block to Load 
00h-07h = Valid values 
O8h-FFFFh = Reserved 


| 28h | Word || Character offset : 
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Function: 10h — Enhanced Load Text Mode Font, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


0000h Successful Operation 
When a user-defined font is loaded, the Count of Charac- 
ters field must not be zero. If set to zero, no font is loaded 
and function OFh returns with Return Code 0000h Success- 


ful Operation. 


[—cooth | twald Function 


C005h Invalid Video Parameter 
When a user-defined font is loaded, the Count of Charac- 
ters and the Character offset fields must not exceed the 
) maximum numbers of characters per character set (700h 
characters). If greater than 100h, function OFh returns with 
a Return Code field of CO05h Invalid Video Parameter. 


FFFFh Return Code Field Not Valid | 
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Function: 11h — Read Palette Register 


Description 


This single-staged function reads the value of the palette register specified 
on function entry. 


Attribute controller, palette registers, and the DAC 


The Attribute Controller component of the VGA hardware contains an internal 
Palette Register. The Palette Register is composed of sixteen 8-bit registers. 
Bits 0-5 can be programmed to any value up to 3Fh (i.e. 64). Bits 7-6 are 
reserved. The value contained in each palette register is combined with 
other Attribute Controller information to create an 8-bit index into the DAC. 


Palette registers are initialized at mode set 


The value programmed into each Palette Register is determined by ABIOS at 
mode set. When a 16-color EGA or VGA mode is selected, ABIOS initializes 
the Palette Register to the 16 default EGA colors. When a 16-color CGA 
mode is selected, ABIOS initializes the Palette Registers to the 16-color CGA 
palette. In mode 13h, ABIOS initializes the entire Attribute Controller so that 
the 8 bit per pixel value used in this mode maps directly into the DAC. 


continued 
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Function: 11h — Read Palette Register, Continued 


Request Block Structure 


00m | Word || Request Bock Length i 
| o2zh_ | Word |[ Logical iD 
ew 
| 06h | Word | 

=e 


punt 
| Function (001th) 
Word a 
a ie oe | 
|_0Ch | Word || ReturnCode -=—FS ssid Return Code sid 


| 16h | Reserved (Initialize to 0000h) 
32h Word Palette Register to Read . 
: 00h-OFh = Valid values 
10h-FFFFh = Reserved | 


Return Codes 


“1 Palette Value Read 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


Successful Operation | 
ae 
[_FRFEH [Return Code Fld Not Val 
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Function: 12h — Write Palette Register 


Description 


This single-staged function writes a particular value to the palette register 
specified on function entry. Valid values are OOh-3Fh. 


This function is valid for all modes except mode 13h. Writing to a palette 
register while in mode 13h may cause unpredictable results. In mode 13h, 
the VGA hardware requires that the Palette Registers remain as programmed 
on mode set. 


Attribute controller, palette registers, and the DAC 


The Attribute Controller component of the VGA hardware contains an internal 
Palette Register. The Palette Register is composed of sixteen 8—bit registers. 
Bits O-5 can be programmed to any value up to 3Fh (i.e. 64). Bits 7-6 are 
reserved. The value contained in each palette register is combined with 
other Attribute Controller information to create an 8-bit index into the DAC. 


Palette registers are initialized at mode set 


The value programmed into each Palette Register is determined by ABIOS at 
mode set. When a 16-color EGA or VGA mode is selected, ABIOS initializes 
the Palette Register to the 16 default EGA colors. When a 16-color CGA 
mode is selected, ABIOS initializes the Palette Registers to the 16-color CGA 
palette. In mode 13h, ABIOS initializes the entire Attribute Controller so that 
the 8—bit per pixel value used in this mode maps directly into the DAC. 


Reference 


KR 


For more information on color palettes, the DAC, and color mode register 
initialization, refer to Hardware Environment in this chapter. 
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Function: 12h — Write Palette Register, Continued 


Request Block Structure 


a 
| 00h | Word | Request Block Length : 2S 
| 02h | Word |i Logical ID : 
| 06h _| 


Uni 
| 08h_| Word _| : 
: 
| 0Ch | Word _| |ReturnCode 
| 16h | Word _| : 


Word Write value to the palette 
register 
0Oh-OFh = Valid write values 
10h-FFFFh = Reserved 

Word Load the palette value 

| 0Oh-3Fh = Valid 
40h-FFFFh = Reserved 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


Description 


0000h _— Successful Operation 
Co000h Invalid Logical ID 
Cooth 


C003h Invalid Unit Number 


C004h Invalld Request Block Length 
C005h Invalid Video Parameter 
FFFFh Return Code Field Not Valid 


invalid Function 


348 | 7 - ABIOS for IBM PS/2 Computers and Compatibles 


Function: 13h — Read DAC Color Register 


Description 


This single-staged function returns the 18-bit Red-Green-Blue (RGB) value 
contained in the DAC color register specified on function entry. 


Digital-to—Analog Converter (DAC) color registers 
The video DAC contains 256 individual color registers. 


Each DAC color register contains one 18-bit RGB analog value. Six bits of 
each register are allocated to each primary color. Thus, the color repre- 
sented in each DAC color register may be any of 256K possible colors 
(i.e. 29*6 = 256K). 


How DAC color registers are initialized 


The ABIOS initializes the 8-bit index values contained in the Attribute Control- 


ler and the 18-bit analog color values contained in the DAC color registers 
each time a video mode is set. 


When a CGA, EGA, or 16-color VGA mode is requested, ABIOS initializes 
the first 64 DAC color registers to analog equivalents of the 64 EGA colors. 
The remaining 192 registers are undefined. When mode 13h (256 color 
mode) is set, ABIOS initializes all 256 color registers to their IBM 
PS/2-compatible values. 


continued 
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Function: 13h — Read DAC Color Register, Continued 


Request Block Structure 


| 00h | Word _ Request Block Length : Se 
Logical ID : 


| 16h | Word |} Reserved (Initialize to 0000h) : 


2Ah Word DAC Color Register to Read 
OOh-FFh = Valid values 
100h-FFFFh = Reserved 


[2h | Word || 


}| Read value 
1] Green value 
=I] Blue value 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


Successful Operation | 
Invalid Logical ID 
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Function: 14h — Write DAC Color Register 


Description 


This single—staged function outputs the 18-bit RGB value contained to the 
DAC color register specified on function entry. 


Digital-to—Analog Converter (DAC) color registers 
The video DAC contains 256 individual color registers. 


Each DAC color register contains one 18-bit RGB analog value. Six bits of 
each register are allocated to each primary color. Thus, the color repre- 
sented in each DAC color register may be any of 256K possible colors 
(i.e. 239*6 = 256K). 


How DAC color registers are initialized 


The ABIOS initializes the 8-bit index values contained in the Attribute Control- 
ler and the 18-bit analog color values contained in the DAC color registers 
each time a video mode is set. 


When a CGA, EGA, or 16-color VGA mode is requested, ABIOS initializes 
the first 64 DAC color registers to analog equivalents of the 64 EGA colors. 
The remaining 192 registers are undefined. When mode 13h (256 color 
mode) is set, ABIOS initializes all 256 color registers to their IBM 
PS/2-compatible values. 


continued 
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Function: 14h — Write DAC Color Register, Continued 


Request Block Structure 


Tc 
: 
| 04h | Word : 
: 
Word : 
: 
| Device control flags i 


Bits 15-3 = Reserved 
Bit 2 = Gray Scale Summing 
0 Disable 
1 Enable 
Bits 1-O = Reserved 


2Ah Word Color Register to Write 
OOh-FFh = Valid write values 
100h-FFFFh = Reserved 


2Ch Word Red Value 


00h-3Fh = Valid value 
40h-FFFFh = Reserved 


2Eh Word Green Value 
0O0h-3Fh = Valid value : 
40h-FFFFh = Reserved 
Word || Blue Value : 
0Oh-3Fh = Valid value i: 

| 40h-FFFFh = Reserved eae 


continued 
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Function: 14h — Write DAC Color Register, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


[Fern | Return Code Fos Not Vale 
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Function: 15h — Read Block of Color Registers 


Description 


This single-staged function reads a block of 18-bit RGB color register values 
from the Digital-to—Analog—Converter (DAC), beginning with the color regis- 
ter specified on function entry. 


A doubleword pointer to the buffer area where the block is to be stored 
must also be specified on function entry. 


Function 16h input field considerations 


= Number of registers to load must be greater than zero 


If the value input into the Number of Registers to Load field is zero, no 
action is performed and function 16h returns with Return Code O000Oh 
Successful Operation 


m Block length must not exceed 100h 


If the value in the First Color Register to Write field plus the value in the 
Number of Color Registers to Write field exceeds 100h, then no action is 
performed and function 16h returns with Return Code COO05h Invalid Input 
Parameter. 


Color register data format 


The block of DAC color register values returned by function 15h is stored in 
a system RAM buffer as a series of three—byte sequences as follows: 


(Red value, green value, blue value) (red value, green value, blue value).... 


The standard range for red, green, or blue values is 00h to 3Fh. The values 
40h to FFFFh are reserved. 


continued 
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Function: 15h — Read Block of Color Registers, Continued 


Request Block Structure 


| 00h | Word | Sereelelelederatetee raced ters cececarscerseranete ta gataratatacal ae yess ate er acer elec ec ae uegecaye ss Aree cere ere ee are tbe etary 
| 02h | Word | 
| 04h | Word _ 
| 06h | Word 

| Word _| 


[Eh a 
| 10h | Word 
Hil Bes 
registers into the save area 
[teh | Word — 
[teh [ Word 


W First color register 


OOh-FFh = Valid read values 
100h-FFFFh = Reserved 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


Successful Operation 
If the value input Into the Number of Registers to Load 

fleld Is zero, no action is performed and function 16h is- 
sues Return Code 0000h Successful Operation 


Coo0oh Invalid Logical ID 


Cooth Invalid Function 
Co00o3h Invalid Unit Number 


C004h Invalid Request Block Length 


Co005h Invalid Video Parameter 

If the value in the First Color Register to Write field plus 
the value in the Number of Color Registers to Write field 
exceeds 100h, no action is performed and function 16h 

returns with Return Code C005h Invalid Input Parameter. 


FFFFh Return Code Field Not Valid 


ABIOS Video Service 355 


Function: 16h — Write Block of DAC Color Registers 


_ Description 


This single-staged function loads a block of 18-bit RGB values to the DAC 
color registers, beginning with the color register specified on function entry. 


The start address of the block of color register values to be loaded is indi- 
cated with a doubleword pointer that is also specified on function entry. 


RGB data format 


The block of RGB color register values to be loaded by function 16h must be 
stored in system RAM as a series of three—byte sequences as follows: 


(Red value, green value, blue value) (red value, green value, blue value).... 


The standard range for red, green, or blue values is OOh to 3Fh. The values . 
40h to FFFFh are reserved. | 


Function 16h input field considerations 


= Device Control Flag and gray scale summing 
When a monochrome monitor is attached, gray scale summing is handled 
automatically by the video hardware. When a color monitor is attached, 
gray scale summing is enabled or disabled by setting the value of bit 2, 
Gray Scale Summing, of the Device Control Flag field. 


= Number of register to load must be greater than zero 
If the value input into the Number of Registers to Load field is zero, no 
action is performed and function 16h returns with Return Code O0000h 
Successful Operation 


= Block length must not exceed 100h 


If the value of the First Color Register to Write field plus the value of the 
Number of Color Registers to Write field exceeds 100h, then no action is 
performed and function 16h returns with Return Code C005h Invalid Input 
Parameter. 


continued 
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Function: 16h — Write Block of DAC Color Registers, Continued 


| Request Block Length 3 
Logical ID : 


Reserved (initialize to 0000h : 
Reserved (initialize to 0000h) eee ae ee 
Return Code 


Reserved (Initialize to 0000h) : 


Pointer to write the color 


registers into the save area 


Reserved (Initialize to 0000h) : 
Number of color registers : 


Device control flags 

Bits 15-3 = Reserved 

Bit 2 = Gray Scale Summing 
0 Disable 
1 Enable 

| Bits 1-O = Reserved 

First color register 


OOh-FFh = Valid write values 
100h-FFFFh = Reserved 


continued 
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Function: 16h — Write Block of DAC Color Registers, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ABIOS performance. 


Code Description : 


0000h Successful Operation 

If the value input into the Number of Registers to Load field 
is zero, no action is performed and function 16h issues 
Return Code 0000h Successful Operation 


Co000h Invalid Logical ID _ ZZ 


Cooith Invalid Function 


C003h | Invalid Unit Number | 
C004h Invalid Request Block Length 


Co005h Invalid Video Parameter 

If the values in the First Color Register to Write and the 
Number of Color Registers to Write field exceed 100h, no 
action Is performed and function 16h returns with Return 
Code C005h Invalid Input Parameter. 


| Return Code Field Not Valid a : | | _ 


FFFFh 
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12 


Chapter 12 


ABIOS Serial Communications 
Service 


Overview 


Introduction 


The ABIOS Serial Communications Service provides access to serial I/O 
device adapters. The functions available provide the caller with a means of 
accessing the system serial ports without directly programming hardware 
controller registers. To maintain maximum compatibility across different 
serial port controllers, direct hardware programming of a controller should 
be avoided. 


continued 
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Overview, Continued 


Summary of ABIOS Serial Communications Service functions 


| Function Description 
Default Interrupt Handier 


| Oth Return Logical ID Parameters 
| O8h Read Device Parameters 


[osn-oan | Reeved CS 
Receive — | 


LO 
| (sh | Return Status Line 

| 14h Return Modem Status 

| 18h Enable FIFO Control 


In this chapter | 
This chapter includes information about the following topics: 
» Hardware Environment 
» Error Handling | 
# ABIOS Serial Communications Service functions 
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Hardware Environment 


Serial port 


The ABIOS supports a National Semiconductor 16550 serial port controller or 
equivalent logic. The serial ports can be addressed as Serial 1-8. See 
(40:10h) to find out how many serial ports are available. Serial 1 and 3 
interrupts are on IRQ 4; Serial 2 and 4 interrupts are on IRQ 3. The serial 
port base addresses are shown below. ABIOS initializes the serial ports in the 
same order that they reside in the ROM BIOS data area, so the serial port 
Logical IDs will be in the same order as in the BIOS Data area (40:10h). 
Additional serial ports and Logical IDs may be initialized. 


Serial port addresses/interrupt levels 


Serial Port Number Base Address interrupt Level 


NS 16550 characteristics 


The NS 16550, which is functionally compatible with the NS 16450 and the 
NS 8250, supports: 


=» Characters of 5, 6, 7, or 8 bits, 
» 1, 1.5, or 2 stop bits, and 
=“ even, Odd, or no parity modes. 


continued 
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Hardware Environment, Continued 


NS 


16550 Serial Communications Controller 


The NS 16550 does serial to parallel conversions on data received from a 
peripheral device or a modem, and parallel to serial conversion on data 
received from the system processor. The system processor can read the 
status of the NS 16550 at any time during its operation. The information 
furnished includes the type and condition of transfer operations in progress, 
as well as any error conditions (parity, overrun, framing, or break interrupt) 
present. The NS 16550 provides complete modem control, and has a user 
programmable processor-interrupt system. 


Programmable baud rate generator 


NS 


362 


The serial port controller can operate at speeds of from 110 to 19,200 bps. 


16550 Serial Controller Registers 
The NS 16550 has 12 accessible registers: 


» Receiver Buffer Register (Read Only) 

» Transmitter Holding Register (Write Only) 

=» Interrupt Enable Register (Read/Write) 

» Interrupt Identification Register (Read Only) 
= FIFO (First in/First out) Control Register (Write Only) 
» Line Control Register (Read/Write) 

= Modem Control Register (Read/Write) 

» Line Status Register (Read Only) 

= Modem Status Register (Read Only) 

=» Scratch Register (Read/Write) 

=» Divisor Latch (LSB) (Read/Write) 

» Divisor Latch (MSB) (Read/Write) 


Information on the operation of these registers is contained in the National 
Semiconductor NS 16550 Data Sheet. However, to avoid any incompatibility 
problems introduced by direct hardware programming, use the access to the 
serial controller provided through the BIOS services. 


continued 
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Hardware Environment, Continued 


I/O port addresses 


The I/O port table in Section 2 provides a complete list of all serial 1/O port 
addresses. These |/O addresses correspond to the serial port registers and 
provide a standard means of access for the caller. 


Error Handling 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


lf Bit 15 of the Return Code field is set, the Serial Communications Service 
function requested has an error. The caller’s Return Code handler routine 
should test Bits 14, 13, 12, and 8 to determine the class of error that has 
occurred and then test the remaining bits to determine the precise nature of 
the error. 
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Function: 00h — Default Interrupt Handler 


Description 


This function is a single—staged or multistaged request that handles unex- 
pected hardware interrupts by resetting the interrupt at the device level. 


When to invoke 


This function is invoked by calling the interrupt routine with a function code 
of O0000h. It is only invoked if a given Logical ID has no outstanding Request 
Blocks waiting for an interrupt. 


Request Block Structure 


a 


| 00h _| Word | : 
| 02h | Word | : 

: 
| 06h | Word | : 
| 08h | Word _ : 
: [ 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[eons [Not My tert, Resume Stage after ivernpt 


FFFFh Return Code Field Not Valid 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns the parameters for the 
specified Logical ID. 


Request Block Structure 


forse] sue [wowed 


| 00h | Word |} Request Block Length (20h) : 
|_02h_ | Word |/ Logical ID 
| 06h _| 


Unit 
| 08h | Word _ 
0Ch 


Device ID (0006h) | 


Count of Units | : 


Logical ID Flags 


Bits 15-4 = Reserved 
Bit 3 = 0 No overlap across 
units (only one unit is 


= Transfer Data Pointer 
Mode Return Codes 
01 = Logical Pointer 
Required 


S| functions) 


continued 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Function: 03h — Read Device Parameters 


Description 


This function is a single-staged request that reads the parameters of the 
serial port(s). This function does not interact with any hardware and has no 
effect on any other outstanding requests. 


Before using this function 


Invoke function 05h Reset/Initialize Serial Device to synchronize the serial 
port parameters before invoking this function. 


How the serial port parameters are set up 


The serial port parameters are maintained in the Serial Port Device Block 
(Device ID O006h). These parameters always reflect the state of the serial 
port hardware. The parameters are updated every time an ABIOS (or CBIOS) 
Serial Communications Service function is invoked. 


Warning: lf the serial ports are directly programmed or programmed using 
CBIOS INT 14h functions after ABIOS initialization, the serial pa- 
rameters in the ABIOS Device Block will not be accurate. 


Initial serial port values 
The serial port(s) is initialized to the following values during ABIOS 
initialization: 
» Baud rate of 1200 
= No parity 
=» One stop bit 
=» Seven Bits Per Character 
=» No break 


continued 
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Function: 03h — Read Device Parameters, Continued 


Request Block Structure 


Fd 
| 00h _| Word _ : : 
— oh] werd 


Reserved (initialize to 0000h) i 
Return Code 


fee (initialize to 0000h) 


Modem Control 


i] Bits 7-5 = Reserved (set to 0) 
1] Bit 4 = 1 Loop 
Bit 3 


= 1 Out2 
Bit 2 = 1 Out! 
Bit 1 = 1 Request To Send 
Bit 0 = 1 Data Terminal Ready 


29h Asynchronous Interrupt Status 


Bits 7-6 = Reserved (set to 0) 
Bit 5 = 1 Modem Status 


Interrupt 
Bit 4 = Reserved 
Bit 3 = 1 Transmit Interrupt 
Bit 2 = 1 Receive Interrupt 


Bits 1,0 = Reserved 
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Function: 03h — Read Device Parameters, Continued 


Request Block Structure, cont’d 


uu 


Parity Type 
| 


00h =None 

O1h = Odd 

O2h = Even 

03h = Stick parity odd 
04h = Stick parity even 


Number of Stop Bits 


Note: The following is true if the 
number of Bits Per Charac- 
ters either 1, 2, or 3. 


0Oh =1 
Oih =2 


Note: The following is true if the 
number of Bits Per Charac- 


ter is 0. 
0Oh =1 
| Oth = 1-1/2 
47h Byte Number of Bits Per Character 
0OOh =5 
Oth =6 
02h =7 
03h =8 


Break Status 


00h = Disabled 
Oih = Enabled 


hal al 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0000h Successful Operation 


| C000h Invalid Logical ID 


Cooth invalid Function 


C003h_ =| Invalid Unit Number 
| C004h Invalid Request Block Length 


FFFFh Return Code Field Not Valid | 
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Function: 04h — Reserved 


Function: 05h — Reset/Initialize Serial Port 


Description 


This function is a single-staged request that initializes the serial port(s) 
according to the specified values. 


Reset process 
When this interrupt is invoked, the ABIOS: 


» cancels all outstanding serial communications Request Blocks, 


= disables all serial port interrupts, including those generated by functions 
OEh Transmit, OFh Receive, 10h Transmit and Receive, and 11h Modem 
Status, 


» clears any pending data at the serial ports, and 
= synchronizes the Device Block parameters so they match the current 


hardware serial port values (this must be done before function 03h Read 
Device Parameters is invoked). 


The caller is responsible for deallocating the appropriate Request Blocks and 
ensuring the appropriate condition of the interrupt controller (by sending 
EOls). | : 


continued 
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Function: 05h — Reset/Initialize Serial Port, Continued 


Request Block Structure 


: 
| ozh_| Word _| 
| 04h | Word _ 
| 08h _| Word _ 
. 
| 18h_| Word _ 7 


Byte Modem Control 

Bits 7-5 = Reserved 

Bit 4 = 1 Loop 

Bit 3 = 1 Out2 

Note: an bit must be 0 if Bit 4 
s 0. | 

Bit 2 = 1 Out! 

Note: Ay bit must be 0 if Bit 4 
s 0. 

Bit 1 = 1 Send 

Bit 0 = 1 Data Terminal 

Ready 


Byte FIFO Trigger Level, where: 
OOh= 1 Byte 
2Ah Byte FIFO Control, where: 
00h = Do not change or 
FIFO not supported 
Oth = Enable and Reset 
FIFO 
O2h-FFh=Enable FIFO 


O1h= 4 Bytes 
| Transmission Baud Rate : 
= 110 | 


O2h= 8 Bytes 
O3h= 14 Bytes 
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ABIOS Serial Communications Service 371 


Function: 05h — Reset/Initialize Serial Port, Continued 


Request Block Structure, cont’d 


foweel] ome pmo fe 


45h Byte | Parity Type 


00h =None 
O1h = Odd 
02h =Even 


03h = Stick parity odd 
04h = Stick parity even 
Number of Stop Bits 


Note: The following is true for a || 
6 bit, 7 bit, or 8 bit word 


length. 
0OOh =1 
Oih =2 


Note: The following Is true for a | 
5 bit word length. | 

0OOh =1 

Oth = 1-1/2 


47h | Byte Number of Bits Per Character 
00h =5 
Oih =6 
02h =7 
03h =8 


Break Status 


00h = Disabled 
O1ih = Enabled 


Line Status 


Bit 7 = Reserved 

Bit 6 = 1 Transmitter Empty 

Bit 5 = 1 Transmitter Holding 
Register Empty 

Bit 4 Break Interrupt 

Framing Error 

Parity Error 

Overrun Error 

Data Ready 


Modem Status 


Data Carrier Detect 
Ring Indicator 

Data Set Ready 
Clear To Send 
Delta Data Carrier Detect 
Trailing Edge Ring 

indicator 

1 Delta Data Set Ready 
1 Delta Clear To Send 


‘ee 
eek ech ek eh eh 


ru wou 
ech eek ch eh ene eh 


Bit 


1 = 
Bit 0 = 
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Function: 05h — Reset/Initialize Serial Port, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Functions: 06h —- 0Ah — Reserved 
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Function: OBh — Set Modem Control 


Description 


This function is a single-staged request that sets the parameters for control 
of the modem as specified in the Request Block. 


This function does not affect any Request Blocks already in process that 
have a Return Code of 0001h Resume Stage after Interrupt or O005h Not My 
Interrupt, Resume Stage after Interrupt. 


Request Block Structure 


Reserved (initialize to 0000h) os 


Return Code Return Code 


Reserved | 


Modem Control 


Bits 7-5 = Reserved (set to 0) 
Bit 4 = 1 Loop 
Bit 3 = 1 Out2 


Note: Us bit must be 0 if Bit 4 
s 0. 


Bit 2 = Out! 


Note: oo bit must be 0 if Bit 4 

s 0. : 
Bit 1 = 1 Request-To-Send 
Bit 0 = 1 Data Terminal Ready | 
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Function: 0Bh — Set Modem Control, Continued 


Return Codes 
This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 
| FFFFn | Return Code Field Not Valid 


Function: 0Ch — Set Line Control 


Description 


This function is a single-staged request that sets the parameters for the line 
as specified in the Request Block. 


This function does not affect any Request Blocks already in process that 
have a Return Code of 0001h Resume Stage after Interrupt or O005h Not My 
Interrupt, Resume Stage after Interrupt. 
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Function: 0Ch — Set Line Control, Continued 


meques: Block Structure 


Cs 


| oon | Word || Request Block Length | 
[02h | Word | 
[06h [Word 
| o8h | Word | 
je 


Reserved (initialize to 0000h) _ 


03h = Stick parity odd 
04h 


Number of Stop Bits 


Note: The following is true for a | 
6 bit, 7 bit, or 8 bit word 
length. 


00h = 1 Stop bit 

Oth = 2 Stop bits | 

Note: The following is true for a 
5 bit word length. 

00h =1 Stop bit 

Oth = 1-1/2 Stop bits 


Number of Bits Per Character 


Byte Parity Type 
00h =None 
O1lh = Odd 
02h = Even 


= Stick parity even 


Byte 


00h =5 bits 
Oih =6 bits 
02h =/7 bits 


03h = 8 bits 


Break Status 


00h = Disabled 
Oih = Enabled 
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Function: 0Ch — Set Line Control, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Function: 0Dh — Set Baud Rate 


Description 


This function is a single-staged request that sets the baud rate as specified 
in the Request Block. 


This function does not affect any Request Blocks already in process that 
have a Return Code of 0001h Resume Stage after Interrupt or O005h Not My 
Interrupt, Resume Stage after Interrupt. 


Request Block Structure 


fewest] ome [mee 
|_04h_ | Word | ' 
|_06h_| Word | : 
| 08h | Word _ : 
| ReturnCode 


|| Reserved (Initialize to 0000h) : 


Transmission Baud Rate 


© 
@ 
7 
i 


19200 
O9h-OFFh = Reserved 
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Function: 00h — Set Baud Rate, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Function: 0Eh — Transmit 


Description 


This function is a discrete multistaged request that enables the transmit 
interrupt. No data is transmitted until the actual transmit interrupt occurs. 


Pointer field definitions 


The Transmit Tail Pointer must point to the first byte of the data block to be 
transmitted. The value in this field should be relative to the beginning of the 
Transmit Buffer. The value in this field must always be between zero and the 
value in the Transmit Buffer Length field minus one. 


The Transmit Head Pointer should point to a location one byte past the last 
byte to be sent. The value in this field should be relative to the beginning of 
the Transmit Buffer. The value in this field must always be between zero and 
the value in the Transmit Buffer Length field minus one. 


continued 
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Function: 0Eh — Transmit, Continued 


Updating the Transmit Tail Pointer field 


When a transmit interrupt occurs, the interrupt routine increments the value 
of the Transmit Tail Pointer by the number of bytes transmitted. Bit 1 (Trans- 
mit In Progress) of the Current Serial Port Status field will be set. 


The Transmit Buffer may be checked at any time during the transmit routine, 
so the ABIOS writes data to the Transmit Buffer before the value in the 
Transmit Tail Pointer field is incremented. 


Transmit Pointer field rules 


The following rules apply to programming the transmit pointer fields: 


The Transmit Tail Pointer field value will always get closer to the Transmit 
Head Pointer value as interrupts occur. 


If the value of the Transmit Tail Pointer comes to the end of the Transmit 
Buffer, the Transmit Tail Pointer field value wraps around to 0. 


A Transmit Buffer Empty condition occurs when the value in the Transmit 
Tail Pointer equals the value in the Transmit Head Pointer field. 


If a Transmit Buffer Empty condition happens after data is sent to the 
serial port, the ABIOS stops sending data and sets bit 6 (Transmit Buffer 
Empty) of the Current Serial Port Status field (the transmit interrupt is still 
enabled). If the empty buffer condition persists on the next transmit 
interrupt (or any transmit interrupt), the ABIOS will then disable the trans- 
mit interrupt. 


If the transmit interrupt is disabled because the transmit buffer is empty, 
the Request Block is canceled by the ABIOS (although it is up to the caller 
to deallocate the Request Block). 


If a Request Block is canceled by the ABIOS, the Current Serial Port 


Status field will have bit 6 (Transmit Buffer Empty) and bit 7 (Transmitter 
Holding Register Empty) set. 


— 380 
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Function: OEh — Transmit, Continued 


Transmit buffer full 


This condition occurs when the value in the Transmit Head Pointer full is one 
less than the value in the Transmit Tail Pointer field. 


It also occurs if zero is in the Transmit Tail Pointer field and the value in the 
Transmit Head Pointer field is one less than the value in the Transmit Buffer 
Length field. 


Adding data during a transmit interrupt 


The values in the Transmit Buffer Segment, Transmit Buffer Offset, and 
Transmit Buffer Length fields can be altered across calls to the transmit 
interrupt routine. 


The ABIOS removes the data from the buffer before changing the Transmit 
Tail Pointer field, therefore the caller can add data to be transmitted during 
the process of a transmit interrupt by placing the data in the Transmit Buffer 
and logically incrementing the value in the Transmit Head Pointer field. 


The caller must not permit the value in the Transmit Head Pointer fieid to 
equal the value in the Transmit Tail Pointer field while it adds data to the 
transmit buffer. 


Maximum number of characters transmitted 


The maximum number of characters that a single view of the Transmit Buffer 
can indicate to be transmitted is one less than the value in the Transmit 
Buffer Length field. 


Number of bits per character 


If the Number of Bits Per Character field in function 05h Reset/Initialize is 
less than 8, the high order bit(s) of each byte are transmitted as is. 
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Function: OEh — Transmit, Continued 


Transmit sequence example 
After the caller initializes the Request Block with a Transmit function (OEh or 
10h) and calls the start routine, the following actions take place: 


1. The ABIOS tests the Transmit Head and Tail Pointers to ensure that they 
agree with the Transmit Buffer Length. The maximum number of charac- 
ters that can be transmitted in this example is 6. 


After the caller calls the common start procedure, the Request Block, Transmit 
Buffer, and Current Serial Port Status field appear as follows: 
nedvest! Block Transmit Buffer 
ame) lef fol 


ranean Buffer Length — 6 : Byte Byte Byte Byte Byte Byte 
Transmit Head Pointer — 5 1 2 3 


Sa | 4 
— ~~ Tall Head 


Pointer Pointer 


Current Serial Port Status 
| 4Bh Bits 15-0 = 0 
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Function: 0Eh — Transmit, Continued 


Transmit sequence example, cont’d 
2. The ABIOS start routine enables the transmitter interrupt but doesn’t send 
any data yet. 


3. ABIOS tests the Transmitter Holding Register (bit 7 of the Current Serial 
Port Status field), finds it empty, and generates a transmit interrupt, 
setting the Return Code field to 0O001h, Resume Stage after Interrupt. 


ABIOS returns to the caller after the start routine with the following: 


Current Serial Port Status 


Bits 15-8 = 0 
1 
0 
1 
0 


Bits 7 = 
Bits 6 — 
Bit 1 = 
Bit O = 


ansmitter Holding Register Empty 


Tr 
Transmit Interrupt Enabled 


Request Block 


S re 0001h 
[Transmit Buffer Length—6 S 

[30h | Transmit Head Pomter— 5 —_—+| 

[sah [Transmit Tail Pointer —O =i 
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Function: 0Eh — Transmit, Continued 


Transmit sequence example, cont’d 


4. The caller, seeing that the ABIOS is waiting for the next interrupt, calls 
the interrupt routine. A character is sent to the active serial port and the 
Transmit Tail Pointer is incremented by one. Byte zero is sent in our 
example below. 


The caller calls the interrupt routine with the following request block 
: . Transmit Buffer 


: econ 
2Ch [Transmit Buffer Length — 6 _ 


Byte Byte Byte Byte Byte Byte 
| 30h |Transmit Head Pointer — 5 0 1 2 3 4 =§ 
| 34h |Transmit Tail Pointer — 1 A & 


, Tall Head 
Pointer Pointer 


“H” has been sent to the | 
serial port | 


Request Block 


Current Serial Port Status 


Bits 15-8 =0 

Bit 7 = 1 Transmitter Holding 
Register Empty 

Bit 1 = 1 Transmit Interrupt Enabled 
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Function: 0Eh — Transmit, Continued 


Transmit sequence example, cont'd 


5. Since the Transmitter Holder Register Empty bit is still set, an interrupt is 
generated by the processor. The caller calls the transmit interrupt routine 
again, and byte one is sent to the serial port. Again, the Transmit Tail 
Pointer is incremented by one. This process is repeated until all bytes in 
the Transmit Buffer are sent (assuming the Transmit Head Pointer is not 
moved by the caller). Actually, standard transmit procedure is that trans- 
mission occurs while the buffer is being filled, so the buffer is never 
empty until all bytes are transmitted. 


Bit 7 in the current Serial Port Status full is set, so the processor generates 


another interrupt (the Return Code sent to the caller is 0001h again). 
The caller calls the interrupt routine to transmit another byte. 


Request Block Transmit Buffer 
sro | [fo] 
| 0001h oe 


Transmit Buffer Length —6 |. Byte Byte Byte Byte Byte Byte 
0 1 2 3 4 5 
| 30h [Transmit Head Pointer — 5 N A 
Transmit Tail Pointer —2 |. =F he 
Pointer Pointer 


“E” has been sent to the 
serial port 
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Function: 0Eh — Transmit, Continued 


Transmit sequence example, cont’d 


6. When all bytes are sent, the Transmit Tail Pointer and Head Pointer point 
to the same location and bit 6 (Transmit Buffer Empty) is set. If bit 6 is 
still set on the next transmit interrupt, the ABIOS disables the transmit 
interrupt, sets a Return Code of 0000h, and returns to the caller. 


After all bytes are set, bit 6 in Current Serial Port Status field is set. 


Current Serial Port Status Transmit Buffer 


Bits 15-8 =0 . | All the betchie fi transmitted 
Bit 7 = 0 Transmitter Holding to the serial port 


Register Empty oe eye ae oe Byte Byte 


Bits 6 1 Transmit Buffer Empty 


Bits 5-0 =0 . Y 


Tail Head 
Pointer Pointer 


if Bit 6 is still set, and the transmit interrupt is disabled, the Return Code is 0000h, 
and ABIOS returns to the caller. 


Request Block 


Transmit Buffer Length — 6_ 
| 30h | Transmit Head Pointer — 5 
| 34h | Transmit Tall Pointer — 5 i 
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Function: 0Eh — Transmit, Continued 


Request Block Structure 


onreet| size || inputs futur; 
| 00h | Word || Request Block Length : Ee 
| 02h_ | Word |] Logical ID 


| Word : 


|_06h_| Word _| 
oan} Word : : 
13h | Were ][7 
| 14h | Word _| : 
|_18h_| Word _| 
[1Ah_| DWord | 
en | a Buffer Length S 
(Return Code is 0000h; no ac- : 
tion taken if zero length input : 
| 2Eh | Word _| é 


[32h [Word _ 
[—34h_| Word || Transmit Tall Pointer 
[~s6h_| Word 


e Current Serial Port Status 


(initialize to O000h) 
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Bits 15-13 = Reserved 
Bit 12 = 1 Overrun Error, with 
Null Data Byte Found 
= 1 Break Detected 
= 1 Framing Error 
Bit 9 = Parity Error 
= 1 


Overrun Error 
Transmit Buffer 
Empty and Transmit- 
ter Holding Register 


Empty 
= 1 Transmit Buffer 


Empty 
Bit 5 = 1 Receive Buffer Full 
and Data Deleted 
Bit 4 = 1 Receive Buffer Full 
Bits 3-2 = Reserved 
Bit 1 = 1 Transmit Interrupt in 
Progress 
Bit 0 = 1 Receive Interrupt in 


Progress 
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Function: 0Eh — Transmit, Continued 


| Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[o00in | Resume Stage ater mternpt 
[ecosn | Not My inerrant, Rasume Stage aor hierupt 


FFFFh Return Code Field Not Valid 
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Function: OFh — Receive 


Description 


This function is a discrete multistaged request that enables the receive 
interrupt. Data can be read from the serial port when a receive interrupt is 
generated after this function is invoked. 


Pointer field definitions 


The Receive Head Pointer must point to the first byte of the data block to be 
received. The value in this field should be relative to the beginning of the 
Receive Buffer. The value in this field must always be between zero and the 
value in the Receive Buffer Length field minus one. 


The Receive Tail Pointer should point to a location one byte past the last 
byte to be received. The value in this field should be relative to the begin- 
ning of the Receive Buffer. The value in this field must always be between 
zero and the value in the Receive Buffer Length field minus one. 


Head Pointer and Tail Pointer fields 


The value in the Receive Head Pointer field points to the first character 
received position that will be filled by the ABIOS. The Value in the Receive 
Tail Pointer field points to the first received character to be removed by the 
caller. 


Updating the Receive Tail Pointer field 


When a receive interrupt occurs, the interrupt routine increments the value 
of the Receive Tail Pointer by the number of bytes received. Bit 0 (Receive 
In Progress) of the Current Serial Port Status field will be set. 


The Receive Buffer may be checked at any time during the receive routine, 
so data is written to the Receive Buffer before the value in the Receive Tail 
Pointer field is incremented. 
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Function: OFh — Receive, Continued 


Receive Pointer rules 


The following rules apply to processing the receive head and tail pointers: 


The Receive Tail Pointer field value will always get closer to the Receive 
Head Pointer value as interrupts occur. 


If the value of the Receive Tail Pointer comes to the end of the Receive 
Buffer, the Receive Tail Pointer field value wraps around to 0. 


A Receive Buffer Full condition occurs when the value in the Receive Tail 
Pointer equals the value in the Receive Head Pointer field. 


lf a Receive Buffer Full condition happens after data is received from the 
serial port, the ABIOS stops receiving data and sets bit 4 (Receive Buffer 
Full) of the Current Serial Port Status field (the receive interrupt is still 
enabled). If the full buffer condition persists on the next receive inter- 
rupt (or any receive interrupt), the ABIOS will then disable the receive 
interrupt. 


If the receive interrupt is disabled because the receive buffer is empty, 
the Request Block is canceled by the ABIOS (although it is up to the caller 
to deallocate the Request Block). 

lf a Request Block is canceled by the ABIOS, the Current Serial Port 


Status field will have bit 4 (Receive Buffer Empty) and bit 5 (Receive 
Buffer Full With Data Deleted) set. 


Receive buffer empty 


This condition occurs when the value in the Receive Head Pointer field 
equals the value in the Receive Tail Pointer field. The ABIOS never sets the 
value of the Receive Head Pointer field equal to the value in the Receive Tail 
Pointer field, however, the caller may do so, which is a quick way to stop 
receiving. 


390 
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Function: O0Fh — Receive, Continued 


How the caller can remove data during a receive interrupt 


The values in the Receive Buffer Segment, Receive Buffer Offset, and Re- 
ceive Buffer Length fields can be altered across calls to the receive interrupt 
routine. 


The ABIOS removes the data from the buffer before changing the Receive 
Tail Pointer field. The caller can remove data during the process of a receive 
interrupt by removing the data from the Receive Buffer and logically incre- 
menting the value in the Receive Head Pointer field. 


The caller must not permit the value in the Transmit Head Pointer field to 
equal the value in the Transmit Tail Pointer field during the removal of data 
from the buffer. 


Maximum number of characters received 


The maximum number of characters that a single view of the Receive Buffer 
can indicate to be received is one less than the value in the Receive Buffer 
Length field. 


Ending a receive interrupt 


A receive interrupt can only be terminated by invoking ABIOS Serial Commu- 
nications Service function 12h Cancel. 


Number of bits per character 


If the Number of Bits Per Character field in function 05h Reset/Initialize is 
less than 8, the high order bit(s) of each byte are transmitted as is. 


continued 
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Function: OFh — Receive, Continued 


Null Stripping Mode 


Plies the following action is taken 


Null Stripping Mode is All received characters are stored unaltered in the 
disabled Receive Buffer. 

ee? Mode is No received zeros are stored in the Receive Buffer. 
enabled 


An Overrun occurs and a The Null Data Byte is discarded. The Current Serial 
Null Data Byte caused Port Status indicates that an overrun error was 
the error found and the Null Data Byte was found and dis- 
cea and bit 12 of the Current Serial Port Status 
eld is set. 


Hardware errors 


lf a hardware error occurs at the serial port, the ABIOS stores the current 
data byte in the receive buffer, sets bits 8-10 of the Current Serial Port 
Status field, and returns to the caller. The ABIOS returns on the first hard- 
ware error, though there may be additional errors and additional data in the 
hardware buffer. 


If there are additional hardware errors at the serial port, the caller must 
handle them and any data that is in the buffer. 


The following table lists the actions taken for each type of error. 


Error Type Action taken by ABIOS 
Break Interrupt Data Byte set to zero. 


Overrun Overrun character Is lost, the Data Byte contains the char- 
acter that caused the overrun. 

Parity Error Data Byte contains the character with the incorrect parity. 

Framing Error Data Byte contains the character that has no valid stop bit. 


continued 


392 ABIOS for IBM PS/2 Computers and Compatibles 


Function: OFh — Receive, Continued 


Receive sequence example 
After the caller initializes the Request Block with a Receive function (OFh or 
10h) and calls the start routine, the following actions take place: 


1. The ABIOS tests the Receive Head and Tail Pointers to ensure that they 
agree with the Receive Buffer Length. The maximum number of charac- 
ters that can be received in this example is 6. 


After the caller calls the common start procedure, the Request Block, Receive 
Buffer, and Current Serial Port Status field appear as follows: 


Request Block | Receive Buffer 
OEh | .| Return Code No bytes received yet. 
FFFFh 


2Ch |Recelive Buffer Length—6 | ; Byte Byte Byte Byte Byte Byte 
30h i. ee 
| ” ~ Head Tail 


: Pointer Pointer 
| Current Serial Port Status 
4Bh Bits 15-0 = 0 


continued 
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Function: OFh — Receive, Continued 


Receive sequence example, cont’d 
2. The ABIOS start routine enables the receive interrupt but doesn’t read 
any data yet. 
3. When data is available at the serial port, an interrupt is generated. 


4. The caller, seeing that the ABIOS is waiting for the next interrupt, calls 
the interrupt routine. A character is read from the active serial port and 
the Receive Tail Pointer is incremented by one. Byte zero is received in 
the example below. 


The caller calls the Interrupt routine with a Receive request. | 


Request Block Receive Buffer — 


. =| Return Code : 

rates we 0001 h eee =% 
Receive Buffer Length — 6 Byte Byte Byte Byte Byte Byte 
Receive Head Pointer — 1 z A - 2 ‘ 


| 40h | Receive Tail Pointer — 5 SS Be 
ee — Head Tail 


Pointer Pointer 
Current Serial Port Status 


Bits 15-5 =0 “H” has been received 
Bit 4 0 Receive Buffer Full from the serial port buffer. 


Bit 0 Receive Interrupt in 
Progress 


continued 
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Function: 0Fh — Receive, Continued 


Receive sequence example, cont’d 


5. Since there are five empty buffer bytes, the data received is read into 
each one in turn when the next receive interrupts are generated. The 
Receive Head Pointer is incremented by one each time. 


Bit 4 In the current Serial Port Status field is not set, so the processor generates another 
interrupt (the Return Code sent to the caller is 0001h again). The caller calls the interrupt 
routine to receive another byte. 


Request Block Receive Buffer 
: eS | Return Code 
0001h 


eat Receive Buffer Length — 6 Lo ee — Byte Byte Byte Byte 

Receive Head Pointer — 2 ‘ 

| 40h | Receive Tail Pointer — 5 - ‘ 
— — Head Tail 


Pointer Pointer 


“E” has been received 
from the serial port buffer. | 


Note: If two or more characters are received at the same time, the Receive 
Head Pointer and the Receive Tail Pointer are incremented by 2 or 
more. The Tail Pointer may then wrap to byte 0. The calling routine 
should anticipate this possibility. 


continued 
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Function: 0OFh — Receive, Continued 


Receive sequence example, cont’d 


6. When all bytes that the receive buffer has room for are received, the 
Receive Head pointer will point to the same byte as the Receive Tail 
Pointer, (or the Receive Tail Pointer will be one byte less than the Receive 
Buffer Length). At this point, a Return Code of 0000h is generated and 
control is returned to the caller. In actual practice, the tail pointer will 
chase the head pointer and the buffer never actually fills. 


After all bytes in the receive buffer are filled, and the Tall Pointer and Head Pointer are the 
same, bit 4 In the Current Serial Port Status field Is set. 


| Current Serial Port Status | | Receive Buffer 


Seu Te [ee fo 
Bit 5 = 0 Receive Buffer Full 


and Data Deleted Byte Byte Byte Byte Byte Byte 


Bit 4 Receive Buffer Empty 0 1 2 3 4 5 


= | 
Bit 0 = 0 Receive Interrupt Not In . 


Progress | | All ad atebs cae 
: : — received from 
| | | Head Tail 
| ine serial pon Pointer Pointer 


If bit 4 is still set, and the receive interrupt is disabled, the Return Code is set to 0000h, 
and ABIOS returns control to the caller. : 
| Request Block | 
| =| Return Code 
| - eu 0000h | 
| 2Ch_ | Receive Buffer Length — 6 | 
a 


[Receive Head Pointer —5 | 
| 40h | Receive Tail Pointer — 5 : 


7. If the Buffer Full condition exists upon entry into the receive function 
interrupt routine, the character that caused the interrupt is lost, and bit 5 
of the Current Serial Port Status field (Receive Buffer Full and Data 
Deleted) is set. 


continued 
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Function: OFh — Receive, Continued 


Request Block Structure 


Ce 


| 02h | Word | 

[oan [Word — 
| 06h | Word | 
oan [Wor 
| 20h | Word 
[aan | Word 
[aan [Word 


Byte Null Stripping Mode 


00h = Disabled 
Oih = Enabled 


Receive Buffer Length 
Note: No action occurs if this 
field is O. 
| 3Eh_ | Word | 


continued 
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Function: OFh — Receive, Continued 


Request Block Structure, cont’d 


Current Serial Port Status 
(initialize to 0000h) 


Bits 15-13 = Reserved 
Bit 12 = 1 Overrun Error, with 
Null Data Byte Found 
1 Break Detected 

Framing Error 
Parity Error 
Overrun Error 
Transmit Buffer ) 
Empty and Transmit- 
ter Holding Register 
Empty 

= 1 Transmit Buffer 
Empty 

= 1 Receive Buffer Full 
and Data Deleted 

= 1 Receive Buffer Full 

= Reserved 

= 1 Transmit Interrupt in 
Progress 

= 1 Receive Interrupt in 
Progress 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


| 0000h__| Successful Operation 
| 000th | Resume Stage after Interrupt 
[coon [Bad ComPot 
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Function: 10h — Transmit and Receive 


Description 


This function is a discrete multistaged request that starts both the transmit 
and receive interrupts, or starts only the receive interrupt. It allows faster 
access to the transmit and receive functions than would be the case if 
separate function requests were used. 


Adding a transmit function to a receive-only function 


Invoke a receive—-only request with this function by only enabling the receive 
parameters (set the Transmit Buffer Length to zero), then calling the start 
routine. The Return Code field, as always, must be initialized to FFFFh when 
calling the start routine. 


The transmit function can be requested later by recalling the start routine 
with an appropriate value in the Transmit Buffer Length field. Do not initialize 
the Return Code field to FFFFh when recalling the start routine. 


If this function is restarted to enable the transmit after being initially set to 
receive only, the Return Code field is undefined when returning from recall- 
ing the start routine and should be ignored. 


Transmit and Receive function characteristics 


This function performs the transmit function as described for function OEh 
and the receive function as described for function OFh, except that during a 
receive interrupt, the transmit interrupt is never disabled. In processing this 
function, the ABIOS does not test if the Transmit Head Pointer and Tail 
Pointer are equal. 


continued 
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Function: 10h — Transmit and Receive, Continued 


input fields to initialize 


After the first time this function is called via a start routine (the Return Code 
field should be initialized to FFFFh the first time), the caller should initialize 
the Current Serial Port Status field and the Return Code field from the previ- 
Ous interrupt to 0000h before the start routine for this function is called 
again. 


Multiple receive interrupts 


400 


After servicing a receive interrupt, the ABIOS tests for a transmit interrupt 
pending condition. 


If a transmit Interrupt is pending, it is serviced by the ABIOS and Return 
Code 0009h Attention, Resume Stage after Interrupt is generated. But if a 
second receive interrupt is pending, the ABIOS does not service the pending 
transmit interrupt, returning to the caller instead. 


continued 
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Function: 10h — Transmit and Receive, Continued 


Request Block Structure 


| 02h | Word _ 
[oan [Word 
o6n [Word] 
[oan Word 
een | Word 
[12h [Word 
| 14h | Word | 
ran [Word 
20n~ [Word — 
[22 [Word 
| 24h | Word | 


Byte Null Stripping Mode 
00h = Disabled 
Oih =Enabled — 


2Ch Word Transmit Buffer Length (bytes) 
lf zero and first call, Receive- 
only function. If zero and second 
call, Return Code = 000th and 
no action is performed 


| 2Eh | Word _| 
| 30h_| Word _ 
| 32h_| Word _ : 
| 34h_| Word _ 
| 36h_| Word _ 


Word Receive Buffer Length 
If zero, no action performed, 
Return Code = 0000h 


[3h _| Word 
ee oe | 


continued 
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Function: 10h — Transmit and Receive, Continued 


Request Block Structure, cont’d 


Current Serial Port Status 
(initialize to 0000h) 


Bits 15-13 = Reserved 

Bit 12 = 1 Overrun Error, with 
Null Data Byte Found 

Bit 11 1 Break Detected 

Bit 10 1 Framing Error 

Bit 9 1 Parity Error 

Bit 8 1 Overrun Error 

Bit 7 1 Transmit Buffer 

Empty and Transmit- | 

ter Holding Register 


Empty 

= 1 Transmit Buffer 
Empty 

= | Receive Buffer Full 
and Data Deleted 

= 1 Receive Buffer Full 

= Reserved 

= 1 Transmit Interrupt in 
Progress 

= 1 Receive Interrupt in 
Progress 


: Com Port Status of Previous 
|| Interrupt 


'|[ Return Code of Previous Interrupt — 


continued 
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Function: 10h — Transmit and Receive, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[oot [Resume stage after ntorupt 
[a00sn [Not My interrupt, Resume Stage after interrapt 
Attention, Resume Stage after Interrupt 
| The Com Port Status of the Previous interrupt field (off- 
Device Busy, Request Refused 
Indicates a hardware failure 


set 4Dh) contains the original status. The Return Code of 
Cco000h | Invalid Logical ID 


the Previous Interrupt (offset 4Fh) has the first Return 
Code. 
Cooth | Invalid Function 
C003h Invalid Unit Number 


C004h | Invalid Request Block Length 
FFFFh Return Code Field Not Valid 
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Function: 11h — Modem Status 


Description 


This function is a discrete multistaged request that returns the Modem Status 
upon exit from the start and interrupt routines. After this function is invoked, 
the modem status interrupt is enabled. 


ABIOS notes changes in modem status immediately 


lf the Request Block that invokes this function is processed before a Trans- 
mit or Receive function (functions OEh, OFh, or 10h), the ABIOS notices a 
change in the modem status even though there may be higher priority inter- 
rupts in the interrupt identification register that are still pending. This allows 
an interrupt handler routine to notice a change in Modem Status before 
receiving or transmitting data. 


continued 
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Function: 11h — Modem Status, Continued 


Request Block Structure 


Request Block Length 


Logical ID : 


Return Code | 
| Time-outt 


0 
=| 
5) 
2) 
a 


c Reserved (Initialize to 0000h : 
: Modem Status 


Bit 7 = 1 Data Carrier Detect 
Bit 6 = 1 Ring Indicator 

Bit 5 = 1 Data Set Ready 

Bit 4 = 1 Clear to Send 

Bit 3 = 1 Change in Data Carrier 


Detect 
Bit 2 = 1 Trailing Edge Ring Indica- 
tor 
Bit 1 = 1 Change in Data Set Ready 
Bit 0 = 1 Change in Clear To Send | 


Current Serlai Port Status 
(initialize to 0000h) 


Bits 15-13 = Reserved 

Bit 12 = 1 Overrun Error, with 
Null Data Byte Found 

Bit 11 Break Detected 

Bit 10 Framing Error 

Bit 9 Parity Error 

Bit 8 Overrun Error 

Bit 7 Transmit Buffer 

Empty and Transmit- 

ter Holding Register 


foi um om a 
om ek mek enh oh 


Empty 
Transmit Buffer 
Empty 
Receive Buffer Full 
and Data Deleted 

= 1 Receive Buffer Full 

= Reserved 

= 1 Transmit Interrupt in 
Progress 

= 1 Receive Interrupt in 
Progress 


continued 
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Function: 11h — Modem Status, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[c00tm | Resume stage after nerupt 
[0s | “Not my inerrant. Resume Stage ater terpt 
[e000 [vais egies 
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Function: 12h — Cancel 


Description 


This function cancels a request for serial transmission (functions OEh or 
10h), receiving (functions OFh or 10h), modem status (function 11h) or any 
combination of these three functions. It also cancels the associated Request 
Blocks, except for function 10h Transmit and Receive (see below). All inter- 
rupts generated by the request are disabled, except for function 10h Trans- 
mit and Receive, which is handled differently (see below). 


Note: The caller must deallocate all canceled Request Blocks. The ABIOS 


does not deallocate Request Blocks. 


Canceling function 10h Transmit and Receive 


Function 10h Transmit and Receive has 
both the transmit and receive interrupts 
enabled, and function 12h Cancel is in- 
voked with the intent of disabling both 
interrupts, 


Function 12h Cancel is to disable only 
the transmit interrupt, 


Function 12h Cancel is invoked with the 
intent of disabling only the receive inter- 
rupt, 


Function 10h Transmit and Receive has 
only the receive interrupt enabled, and 
function 12h Cancel is invoked to disable 
the receive interrupt, 


Function 10h Transmit and Receive has 

only the transmit interrupt enabled, and 
function 12h Cancel Is invoked to disable 
the transmit interrupt 


ABIOS Serial Communications Service 


the Request Block for function 10h is 
canceled by the ABIOS. 


the caller may re-invoke the 10h Trans- 
mit and Receive function via the start 
routine after the function 12h Cancel re- 
quest is completed. 


the caller must complete the following 
steps to re-enable the receive Interrupt: 


| # disable the transmit interrupt 


*® call the start routine with function 10h 
Transmit and Receive specified in the 
Request Block 


| the entire function 10h Transmit and Re- 
ane ee Block is canceled by the 


the entire function 10h Request Block is 
canceled by the ABIOS. 


continued 
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Function: 12h — Cancel, Continued 


Request Block Structure 


Toner] sie [mow doe 


[02h | Word | 
|_08h_| Word _| : 


Reserved (Initialize to 0000h) : 


Interrupt Operation to be 
Canceled 


Bit 7 = Reserved 

Bit 6 = Reserved 

Bit 5 = 1 Modem Status 
interrupt 

Bit 4 = Reserved 

Bit 3 = 1 Transmit Interrupt 

Bit 2 = 1 Receive interrupt 

Bit 1 = Reserved 

Bit 0 = Reserved 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Function: 13h — Return Line Status 


Description 
This function, a single-staged request, reads the Modem Line Status. 


Request Block Structure 


foveei] see [mew dome 
| 00h | Word |{ Request Block Length | : 
| 02h _| Word | : 
| 04h | Word _ 
| 08h_| Word | : 
| 


Line Status 

Bit 7 = Reserved 

Bit 6 = 1 Transmitter Empty 

Bit 5 = 1 Transmitter Holding 
Register Empty 

1 Break Interrupt 

1 Framing Error 

Parity Error 

1 


Overrun Error 
Data Ready 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[coos | hvala Request ook Length 
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Function: 14h — Return Modem Status 


Description 


This function is a single-staged request that reads the current status of the 
modem. 


If the Modem Status interrupt is enabled, no processing takes place and the 
Request Refused, Device Busy Return Code (8000h) is returned. 


Request Block Structure 


jortset| size [inputs ff outputs 
| 02h | Word _| 

04h | Wore 
| 06h | Word 
| 08h | Word _| 
| 0Eh | Word |}. 


| —— ane Soa ae unieeeaerennaas 
Bit 7 = 1 Data delta Detect 

Bit 6 = 1 Ring Indicator 

Bit 5 = 1 Data Set Ready 

Bit 4 = 1 Clear To Send 


Bit 3 = 1 Delta Data Carrier 
Detect 
Bit 2 = 1 Trailing Edge Ring 
Indicator 
1 = 1 Delta Data Set Ready 
0 = 1 Delta Clear To Send 


continued 
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Function: 14h — Return Modem Status, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Function: 15h — Enable FIFO Control 


Description 


This function is a single-staged request that enables FIFO (first-in, first-out) 
control for the serial port. The FIFO registers are not cleared. 


This function may only be used if the ABIOS is operating on an 
80386-—based, MCA-based system which has an NS16550A serial controller. 
lf the serial controller is not an NS16550A, unpredictable results may occur. 


Reusing this function 


ABIOS calling routines should not reuse this Request Block for other Serial 
Communications Service function requests, since the structure of this Re- 
quest Block is different from the other Serial Communications Service Re- 
quest Blocks. | 


Request Block Structure 


[ooh | Word |[ : 
| 02h _ | Word | : 

| Unit | 
ia — We Fini Ce me 
|_o8h_| Word : 


_Return Code | | 
| 0Eh | Word _ | Time-out_ 


Word FIFO Trigger Level, where: 


00h — 1 Byte 
Oih — 4 Bytes 
02h — 8 Bytes 


03h — 14 Bytes 


continued 
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Function: 15h — Enable FIFO Control, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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13 


Chapter 13 
ABIOS Parallel Port Service 


Overview 


Introduction 


The ABIOS Parallel Port Service provides access to the system’s parallel 
ports. Parallel ports on personal computers are most often used to send 
data to printers. This ABIOS service supports only the Transmit Mode of the 
parallel port. 


continued 
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Overview, Continued 


Summary of Parallel Port Service functions 


| 00h Default Interrupt Handler 


Return Logical ID Parameters 


<a Read Device Parameters 


[Resetiniaie Paral PortSSCSCSCS~* 
a 
[oan | Resones CCSC“‘“~“s*s‘“‘*~*Y 
[can | Cancel Print Sock ——SSSCSC~C~S~S~S 
[een Retun printer Stats SSS~S 


In this chapter 
This chapter includes information about the following topics: 
» Hardware Environment 
» Error Handling 
# Parallel Port Service functions 
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Hardware Environment 
SE a ET IE I NT ET ET ETT TEE SCS SIO IE DE STE EIT TTA IS ERE EES 


Introduction 


The ABIOS Parallel Port Service is associated with hardware interrupt request 
7. The ABIOS supports a parallel port that can transfer eight bits of data at 
standard TTL levels. The parallel port can be called port 1 through 8, must 
be IBM PS/2-compatible, and must have a bidirectional mode, supporting 
both input and output. The parallel port also supports level—sensitive inter- 
rupts and a readable interrupt pending status. 


Parallel port addresses 


The following table lists the parallel port addresses for the most frequently 
used parallel ports. The I/O port addresses for parallel ports 4 through 8 
vary among different systems. 


Parallel Data Status Control 
Port Number Address Address Address 
a as 0378h 0379h 037Ah 


ee 0278h 0279h 027Ah 


Parallel port extended mode 


The extended mode of the parallel port can be selected through the system- 
based POS registers. The extended mode adds a bidirectional interface. 


ABIOS Parallel Port Service 417 


Error Handling 


RAE SE A TLE LT IE I ae TD ITI ED LE ET RE ED 
Parallel Port Service errors 


If the parallel port is busy when the caller invokes an ABIOS Parallel Port _ 
Service function, Return Code 8000h Device In Use is returned. The caller 
must then re-invoke the function, except when using function O9h Print 
Block. See the function O9h Print Block description for more information 
about re-invoking function O9h Print Block. 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


If Bit 15 of the Return Code field is set, the Parallel Port Service function 
requested has an error. The caller’s Return Code handler routine should then 
test Bits 14, 13, 12, and 8 to determine the class of error that has oc- 
curred. The return code handler routine should then test the remaining bits 
to determine the precise nature of the error. 
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Function: 00h — Default Interrupt Handler 


Description 


This function is a single-staged or multistaged request that handles unex- 
pected hardware interrupts by resetting the interrupt at the device level. It is 
invoked through the interrupt routine. 


When invoked 


This function is invoked by calling the interrupt routine with a function code 
of O0000h. It is only invoked if a given Logical ID has no outstanding Request 
Blocks waiting for an interrupt. 


Request Block Structure 


[02h | Word | 

| 04h | Word | 
[06h | Word 
| OEh | Word _ 


Return Code 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 
0000h Successful Operation 


Not My Interrupt, Resume Stage after Interrupt 


FFFFh Return Code Field Not Valid 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns the parameters for the 
specified Logical ID. 


Request Block Structure 


| 00h | Word |] Request Block Length (20h) : 
| 02h _| Word || Logical ID | 


Unit 
| 06h | Word 
| 08h | Word | 
LLL 


[ton | ayte 
| iih | Byte | 
[12h | Word 


Count of Units 


Word Logical ID Flags 
Bits 15-4 = Reserved 
Bit 3 = 0 No overlap across 
units 
= 1 Overlap across units 
supported 
Bit 2 = 0 Reserved 
Bits 1-O = Transfer Data Pointer 
Mode 
01 = Logical Pointer 
Required 


Kel Bead 


i 


| Reserved (initialize to 0000h) ‘| 
| 1Eh | Word || Reserved (initialize to 0000h) : 


w 
< 
or 
: 


continued 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Code 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Function: 0Ah — Reserved 


Function: 03h — Read Device Parameters 


Description 


This function is a single-staged request that returns the parameters of the 
specified Logical ID. 


Input field values 


The value in the Time to Wait for Printer Initialization field is the same as the 
value in the Time To Wait Before Continuing Request (microseconds) field 
returned by the Reset/Initialize Parallel Port function (O5h). 


The value in the Printer Interrupt Time—out field is the wait time for an inter- 
rupt at the device level returned by the Print Block function (O9h). 


continued 
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Function: 03h — Read Device Parameters, Continued 


Request Block Structure 


| Word || Request Block Length ___ 


reserve (initialize to 0000h) : 


Word 
ReturnCode 
- 


Time to Wait for Printer Initialization 
(microseconds) 


| Interrupt Level | Interrupt Level 
Printer Interrupt Time-out 


Bits 15-3 = Time-out (in seconds) 
Bits 2-0 = Reserved 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0000h Successful Operation 


Cco000h Invalid Logical ID 


Co0th Invalid Function | 
C003h invalid Unit Number 


Cc004h Invalid Request Block Length 


FFFFh Return Code Field Not Valid 


422 ABIOS for IBM PS/2 Computers and Compatibles 


Function: 04h — Set Device Parameters 


Description 


This function is a single-staged request that sets device specific information 
as specified in the Request Block. 


Input parameters 


The ABIOS uses the parameters input in this function until they are changed 
by another function 04h request for this service. 


The value in the Time To Wait Before Continuing Request field returned by 
the Reset/Initialize Parallel Port function (05n) can be entered into the Time 
to Wait for Printer Initialization field at offset 20h. 


Request Block Structure 


| 00h _| Word _| 
: 
| 06h | Word _| 
| 08h | Word _| : 
: : 

OCh 
| OEh_ | Word |} 
| Reserved (Initialize to 0000h) sf: : 


DWord Time to Wait for Printer 
Initialization (microseconds) 
Note: This field must not be 0. 


Printer Interrupt Time-out 


Bits 15-3 = Time-out 
(in seconds) 
Bits 2-0 = Reserved 


Note: This field must not be 0. 


continued 
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Function: 04h — Set Device Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0000h Successful Operation 


8000h Device In Use 
If the Parallel Port is busy, this Code is returned and the 
function is terminated. 


Co006h Invalid Time To Wait 
The Time to Wait for Printer Initialization field must not be 
zero. If it is zero, this Return Code is generated, no up- 

date is performed, and the function is terminated. 


FFFFh Return Code Field Not Valid 
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Function: 05h — Reset/Initialize Parallel Port 


Description 


This function is a discrete multistaged request that initializes or resets the 
parallel printer. 


Printer Busy Status 


After completing this function, the printer may indicate a Busy status be- 
cause it is performing a self test. Bit 7 (Busy) of the Printer Status at offset 
28h in the Request Block indicates this condition. 


Output considerations 


The Time To Wait Before Continuing Request field value is returned only 
when the Return Code is 0002h Resume Stage after Time Delay. The value 
in this field may not be valid if the Return Code is not 0002h. 


The Printer Status field and all other output fields are not valid unless this 
function has completed. 


oprnenorrersmeme 


Request Block Structure 


| 00h | Word | Request Block Length | ie 
02h Logical ID 


Uni 
[oan | Word || Reserved (intialze to 0000m) 
: 


| Time-out 


“|| Time To Wait Before Continuing | 
Request (microseconds) 
Printer Status 


Bit 7 = Busy 
Bit 6 = Acknowledge 
Bit 5 = End of paper 
Bit 4 = Selected 
Bit 3 = |/O error 

| Bit 2 = Interrupt 
Bits 1, 0 = Reserved 


continued 
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Function: 05h — Reset/Initialize Parallel Port, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[onnan | Resume stage ater Time Boley 


Functions: 06h - 08h — Reserved 
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Function: 09h — Print Block 


Description 


This function is a discrete multistaged request that sends the block of char- 
acters pointed to by Data Pointer 1 to the parallel port. 


Using the Print Block function 


The following steps must be completed before the Print Block function can 
be invoked: 


1. Invoke function 01h Read Device Parameters to determine the Data 
Pointer Mode (logical for Parallel Port Data Pointers). If there is an out- 
standing Print Block function already enabled, function OBh Cancel Print 
Block must be invoked before function 9Fh is invoked. 


2. Invoke function OSh Print Block 


3. Check the Printer Status. The Printer Status field data is valid only if this 
function is completed. The ABIOS does the following, depending on the 
Printer Status bit settings: 


then ABIOS... 


the Printer Status Is Busy (Bit 7) and the Status is still returns 8001h and 
the ABIOS reads the Printer Status Busy, terminates. 
field for 91.2 microseconds 


the printer is switched offline during the Status is still returns 8001h and 
a Print Block (Bit 2) and the ABIOS Interrupt on, terminates. 

reads the Printer Status field for 

91.2 microseconds 


the printer is out of paper, has an either Bits 3, 4, returns 9000h and 
1/O error, or is not selected (Bits or 5 of the terminates. 

3,4, or 5) and the ABIOS reads the Printer Status 

Printer Status field for 91.2 micro- are still on, 

seconds 


4. The caller can then complete the Print Block function as described below. 


continued 
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Function: 09h — Print Block, Continued 


Completing a Print Block Request after an unexpected termination 


If this function is terminated, the Number of Characters Printed field contains 
the part of the print block that has already been printed, in bytes. 


The unprinted portion of the print block can be printed by invoking function 
O9h Print Block again after correcting the condition that caused the termina- 
tion of the initial Print Block function. The number of characters remaining to 
be printed is equal to the original print block length minus the value in the 
Number of Characters Printed field. 


Request Block Structure 


Reserved (Initialize to 0000h) S 


| Data Pointer 1 (Logical Pointer) 


| Number of Characters Printed = 
1] Printer Status 
Bit 7 = Busy 


Bit 6 
Bit 5 
Bit 4 


Acknowledge 
End of paper 
Selected 
Bit 3 1/O error 
Bit 2 Interrupt 
Bits 1, 0 = Reserved 


continued 
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Function: 09h — Print Block, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[000th | Resume stage ater hiorapt 
[—oo0sn | Not my trrpt, Resume Stage ater nterapt 


8001h Device Busy 


lf the printer does not indicate that it is ready to accept 
data within 91.2 microseconds, the Printer Status field is 
updated, the printer interrupt is disabled, and control is 
returned to the caller with this Code. 

9000h Printer Error 
Printer |/O error, out of paper, paper jam, or printer not 
selected. 

Cco00oh Invalid Logical ID 

Cooth Invalid Function 

C003h Invalid Unit Number 


C004h invalid Request Block Length 
FFFFh Return Code Field Not Valid 


Function: 0Ah — Reserved 
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Function: OBh — Cancel Print Block 


Description 


This function is a single-staged request that cancels an outstanding function 
O9h Print Block by disabling the Printer Interrupt at the device level and 
changing the Return Code. 


The Printer Status field is valid only if this function has successfully 
completed. 


Request Block Structure 


| 
| 08h | Word | 
Word : , 
| 0Ch | Word _ 
ee 


Reserved (Initialize to 0000h) 


Number of Characters Printed 


Printer Status 


Bit 7 = Busy 

Bit 6 = Acknowledge 
Bit 5 = End of paper 
Bit 4 = Selected 

Bit 3 = |/O error 

Bit 2 = Interrupt 


Bits 1, 0 = Reserved 


continued 
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Function: 0OBh — Cancel Print Block, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


ABIOS Parallel Port Service 431 


Function: 0Ch — Return Printer Status 


Description 


This function is a single-staged or multistaged request that returns the 
printer status. 


The printer status data is valid only if the function is completed successfully 
(the Return Code is 0000h). 


dust eactihe Block Structure 


00h Tiea[[Regen Soares} RESISTERSISRSRSRSESI SEER SRERSSSRSESRODSEIDEIDD SPEEDS SE SLEDT IE SIEESEEIICDSTOO ERROR OREO SESE ERRORS EER OSTEO : 
| Word || Logical ID 

04h werd | unit 

o6h_[ Word |{ Function (000Ch) 

| Word || Reserved (initialize to 0000h)__|| 


OAh Reserved (initialize to 0000h) Se : 


| ReturnCode Cd” 
[Word If 
ae er Reserved (Initialize to 0000h) —_— 


Printer Status 

Bit 7 = Busy 

Bit 6 = Acknowledge 

Bit 5 = End of paper 

Bit 4 = Selected 

Bit 3 = 1/O error 
Bit 2 = Interrupt 
Bits 1, 0 = Reserved 


continued 
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Function: 0Ch — Return Printer Status, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[0002 | Resume stage after Tine Doky 
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Chapter 14 
ABIOS System Timer Service 


Overview 


Description 
The ABIOS System Timer Service provides access to the PS/2-compatible 
System Timer. The System Timer Interrupt is handled through function OOh 


Default Interrupt Handler. 


Summary of Ser: Timer Service functions 


Default Interrupt Handler 


a Return Logical ID Parameters 


In this chapter 
In this chapter, the following topics are discussed: 


« Hardware Environment 
® Error Handling 
# ABIOS System Timer Service functions 
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Hardware Environment 


Introduction 


PS/2-compatible operation of the Programmable Timer is similar to the 
operation of the Intel 8254A Programmable Interval Timer. Unlike the 8254A, 
the PS/2 programmable timer provides no channel 1 and adds a channel 3 
with limited functionality. | 


Programmable Timer 


The PS/2-compatible Programmable Timer is a counter and timer that pro- 
vides three channels. All channels are driven by a 1.19 MHz oscillator signal. 
Each “tick” of channel 0 generates hardware interrupt request 0. 


Timer channel differences 
There are some differences between the three timer channels: 


Counters O and 2: 

=" are independent 16-bit counters, 

= can be preset, and 

= can count in BCD (binary coded decimal) or in binary. 


Counter 3 (associated only with channel 0): 
» is only 8 bits, 

= can be preset, 

= counts in binary only, and 

=" can only count downward. 
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Error Handling 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


lf Bit 15 of the Return Code field is set, the System Timer Service function 
requested has an error. The caller’s Return Code handler routine should then 
test Bits 14, 13, 12, and 8 to determine the class of error that has oc- 
curred. The return code handler routine should then test the remaining bits 
to determine the precise nature of the error. 
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| Function: 00h — Default Interrupt Handler 


Description 


This function is a single-staged or multistaged request that handles unex- 
pected hardware interrupts by resetting the interrupt at the device level. This 
function is only invoked if a given Logical ID has no outstancing Request 
Blocks waiting for an interrupt. 


If successful, this function resets the Timer 0 channel at I/O port 0061h and 
returns to the caller with a Return Code of O000h. 


If another interrupt routine is entered by any other caller while this function is 
being processed, Return Code 0005h is generated. 


Request Block structure 


| Word | gical ID : 


Word Request Block Length (10h) Ee 
Word || Logical ID —C—~—idCi*CSC 
Unit 


I inns 
Teen [wore reserved nats non 
ocr 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper ene 


a a 


FFFFh Return Code Field Not Valid 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns information about the 
specified Logical ID. 


Request Block structure 


forvei] see [mew Ce 


Request Block Length (20h) oe 
| 02h _| Word || Logical ID : 


Unit : 
| 06h | Word |{ Function (000th : 
| 08h | Word |] Reserved (initialize to 0000h : 


Reserved (Initialize to 0000h) : : 


Device ID (0007h) _ 
Count of Units (0000h) 
Logical ID Flags (0000h) 


Bits 15-4 = Reserved 
Bit 3 = 0 No overlap across 


=/=/= (PI Vi=l= 
Zi NI iol aia i= 
Qa;1aoia o;O 


units 
Bit 2 = 0 Reserved 
Bits 1-0 = Transfer Data Pointer 
Mode 
00 = No Pointers 
Required 


Request Block Length (for other 
functions 7 


| 1Bh | Byte 


i 
3/5 
a;a 


continued 
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Function: 0ih — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[coosn | Not my interrupt, Resume Stage afer erupt 
[—cootm [vata Function 


Functions: 02h - 0Ah — Reserved 


440 ABIOS for IBM PS/2 Computers and Compatibles 


13 


Chapter 15 
ABIOS Real Time Clock Service 


Overview 


Introduction 


The ABIOS Real Time Clock Service provides access to the system’s real 
time clock (RTC) functions. 


Real time clock interrupt types 
This service controls the operation of the following RTC interrupt types: 


@ Alarm interrupt 
An interrupt that is activated at intervals of from once per second to once 
per day. 

@ Periodic interrupt 
An interrupt that is activated at a prespecified interval, which can be from 
.5 second to 30.517 ms. 

= Update-Ended interrupt 
An interrupt that is activated every time the system clock is updated, or 
once per second. 


See the Time-of-Day Service chapter in CB/OS for IBM PS/2 Computers and 
Compatibles in the Addison-Wesley Phoenix Technical Reference Series for 
more information on these interrupt types. 


continued 
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Overview, Continued 


Summary of ABIOS Real Time Clock Functions 


| 00h Default Interrupt Handler 
| Oth Return Logical ID Parameters . 


oir-oan | Reseres 


Read Time and Date 
| ah Write Time and Date 


In this chapter 
This chapter presents information on the following topics: 
« Hardware Environment 
= Real Time Clock Data Definitions 
» Error Handling 
» Real Time Clock functions. 


442 ABIOS for IBM PS/2 Computers and Compatibles 


Hardware Environment 


MC146818A real time clock 


The ABIOS Real Time Clock Service supports a real time clock compatible 
with a Motorola MC146818A. It is associated with interrupt request 8. NMIs 
are disabled any time the ABIOS Real Time Clock service accesses system 
CMOS RAM (first 64 bytes of CMOS RAM). The real time clock is assumed 
to be battery—backed so that the time and date are maintained when the 
computer is powered off. 


Accessing the Real Time Clock CMOS RAM 
To write to the Real Time Clock CMOS RAM: 
# inhibit interrupts. 


write the CMOS RAM address to which the data is to be written to I/O port 
0070h. 


write the data to be written to I/O port 0071h. 


To read from RTC CMOS RAM: 


inhibit interrupts. 


write the CMOS RAM address from which the data is to be read to |/O 
Port 0070h. 


read from 1|/O port 007th. 


RTC CMOS RAM Addresses 
Me oe table lists the I/O port addresses used to access RTC CMOS 


1/O Address pesenenen 


0070h 1 Byte “CMOS RAM address, where: 
Bit 7 = 1 NMI disabled 
Bits 6-0 = 0 CMOS RAM address 


0071h CMOS RAM data port 
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Real Time Clock Data 


Real time clock data definitions 


Real time clock information uses CMOS RAM addresses OOh-OEh. These data 
definitions are presented below in offset order. 


Status register A, where: 


Bit 7 = 1 Update in progress 
1 Byte 


Bits 6-4 = Divider identifying the time-based 
frequency to use 

Bits 3-0 = Rate selection bits that define output 

frequency and periodic interrupt rate 


Status register B, where: 


Bit 7 = 0 Run 
= 1 Halt 
Bit 6 = 1 Enable periodic interrupt 
Bit 5 = 1 Enable alarm interrupt 
Bit 4 = 1 Enable update-ended interrupt 
Bit 3 = 1 Enable square wave interrupt 
Bit 2 = 1 Calendar is In binary format 
= 0 Calendar Is in BCD format 
Bit 1 = 1 24-hour mode 
= 0 12-hour mode 
Bit 0 = 1 Enable Daylight Savings Time 


OCh 1 Byte Status register C, where: 


Bits 7-4 = IRQF, PF, AF, and UF flags, 
respectively 
Bits 3-0 = Reserved 


1 Byte Status register D, where: 


Bit 7 = 1 Real time clock has power 
Bits 6-0 = Reserved 


continued 
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Real Time Clock Data, Continued 


Real time clock data definitions, cont'd 


Diagnostic status, where: 


Bit 7 = 1 Real time clock lost power 

Bit 6 = 1 CMOS RAM checksum is bad 

Bit 5 = 1 Invalid configuration information found 
at POST 

Bit 4 = 1 Memory size compare error at 
POST 


Bit 3 = 1 Fixed disk or adapter fails initialization 
Bit 2 = 1 CMOS RAM time found invalid 

Bit 1 = 1 Adapters do not match configuration 
Bit 0 = 1 Time-out reading an adapter ID 


Error Handling 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


If Bit 15 of the Return Code field is set, the Real Time Clock Service function 
requested has an error. The caller’s Return Code handler routine should then 
test Bits 14, 13, 12, and 8 to determine the class of error that has oc- 
curred. The return code handler routine should then test the remaining bits 
to determine the precise nature of the error. 
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Function: 00h — Default Interrupt Handler 


Description 


This function is a single-staged or multistaged request that handles unex- 
pected hardware interrupts by resetting the interrupt at the device level. 


When to invoke 


This function is invoked by calling the interrupt routine with a function code 
of O00O0h. It is only invoked if a given Logical ID has no outstanding Request 
Blocks waiting for an interrupt. 


Request Block structure 


Torwei] sae 


iS Request Block Length (10h) 


| 02h_| Word || Logical ID 

Unit 

| 06h | Word |] Function (0000h) | 

| 08h | Word | 
| 0Eh_ | Word {I 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


|[F-o00sn | “Not my interrupt, Resume Stage afer inerrpt 


FFFFh Return Code Field Not Valid 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns information about the 
specified Logical ID. 


Request Block Structure 


| 
| 

| 

: 


: 
|] Device ID (0008h) 

Count of Units (0000h) 

Logical ID Flags (0000h) 


Bits 15-4 = Reserved 

Bit 3 = 0 No overlap across 
units 

Bit 2 = 0 Reserved 

Bits 1-0 = Transfer Data Pointer 


ode 
00 = No Pointers 
Required 


: 17 Request Block Length (for other 
: 41 functions) 


jE 


continued 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 
0000h Successful Operation 
Co00oh Invalid Logical ID 
Cooth Invalid Function 

| CO03h Invalid Unit Number 


C004h Invalid Request Block Length 
FFFFh Return Code Field Not Valid 


Function: 02h — Reserved — 
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Function: 03h — Read Device Parameters 


Description 


This function is a multistaged request that returns the most recent interrupt 
settings and Real Time Clock Status for this device in the Request Block. 
NMis are disabled when ABIOS accesses system CMOS RAM. 


Real Time Clock processing 


The Periodic Interrupt Rate field is valid only if the periodic interrupt is 
enabled; the Alarm fields are valid only if the alarm interrupt is enabled. 


ABIOS test for update-in-progress 


If the Return Code is 8000h Device in Use or 8001h Real Time Clock Not 
Started the real time clock is halted. This request is not processed until the 
real time clock is set. 


continued 
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Function: 03h — Read Device Parameters, Continued 


Request Block structure 


[02h | Word _ | 
| 04h | Word _ 
| 06h | Word _ : 
|_08h_| Word _ : 

- e 
Periodic Interrupt Rate, 


Bits 7-4= Reserved 

Bits 3-O= Rate value set 
0000b = None 
0001b = 30.517 ms 
0010b = 61.035 ms 
0011b = 122.07 ms 
0100b = 244.141 ms 
0101b = 488.281 ms 
0110b = 976.562 ms 
0111b = 1.953125 ms 
1000b = 3.90625 ms 
1001b = 7.8125 ms 
1010b = 15.625 ms 
1011b = 31.250 ms 

1100b = 62.500 ms 

1101b = 125.00 ms 

1110b = 250.00 ms 

1111b = 500.00 ms 


Real Time Clock Status Byte 


Bit 7 = Set bit status 
0 Clock started 
1 Clock not started 
Bit 6 = Periodic Interrupt bit 
0 Interrupt disabled 
1 Interrupt enabled 
Bit 5 = Alarm interrupt bit 
0 Interrupt disabled 
1 Interrupt enabled 
Bit 4 = epee eres interrupt 
t 
0 Interrupt disabled 
1 Interrupt enabled 
Bits 3-2 = Reserved 
Bit 1 = Clock mode 
0 12-hour clock 
1 24-hour clock 


[Byte || Function || Alarm Hour In BCD (00-23) 
[Word || Reserved (initiaize to 0000n) | 


continued 
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Function: 03h — Read Device Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 


all valid bits in the Return Code field to ensure proper performance. 


Code Description 


0000h Successful Operation 


If the Alarm Interrupt Is disabled, a Return Code of 
0000h Is generated. 


Device in Use 


Real Time Clock Not Started 


If the real time clock is not started, this code is 
generated and no other fields are valid. 


8000h 
8001h 
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Function: 04h — Set Device Parameters 


Description 


This function is a single-staged request that sets the Real Time Clock Hour 
Modes (either 12-hour clock or 24-hour clock), and the Daylight Savings 
Update field (either enabled or disabled). If the RTC is not functioning, 
ABIOS does not perform this function and generates Return Code 8001h, 
RTC Not Started. ABIOS disables NMIs when accessing system CMOS RAM. 


Request Block structure 


Real Time Clock Mode, where: 


Bits 7-2 = Reserved 
Bit 1 = Hour mode 
0 12-hour clock 
1 24-hour clock 
Bit 0 = Daylight Savings 
Update, where: 
0 = Enabled 
1 = Disabled 


: 
| 06h | Word _ 
| 08h _| Word _| 
| OAh | Word | | 
| Word |ReturnCode id 
OEh 
Byte 


08h 
OAh 
| 0Eh | 


continued 
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Function: 04h — Set Device Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Functions: 05h — 0Ah — Reserved 
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Function: 0Bh — Set Alarm Interrupt 


Description 


This function is a multistaged request that sets the time for an alarm inter- 
rupt. If the RTC is not functioning, ABIOS does not perform this function and 
generates Return Code 8001h RTC Not Started. ABIOS disables NMIis when 
accessing system CMOS RAM. 


ABIOS test for update-in-progress 


If the Return Code is 8000h Device in Use or 8001h Real Time Clock Not 
Started the real time clock alarm is halted. This request is not processed 
until the real time clock alarm is set. 


Real time clock update cycle 


In the IBM PS/2 BIOS, if the real time clock is in an update cycle when this 
function is requested, Return Code 8000h, Device Busy, Request Refused, is 
generated. The Phoenix BIOS aborts the clock update cycle and performs 
the function in this case. 


Setting the alarm 


The following steps must be followed to set the alarm function: 


1, 


If there is an outstanding Set Alarm Interrupt already enabled, function 
OCh Cancel Alarm Interrupt must be invoked before function OBh is 
invoked. 


2. Invoke function OBh Set Alarm Interrupt. 
3. Check the Return Code. 
4. \If the Return Code is 000th, the Interrupt Pending Status field indicates 
the interrupts that occurred. 
5. Query the Return Code just one time; make sure that all indicated inter- 
rupts are processed, sequentially. 
continued 
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Function: OBh — Set Alarm Interrupt, Continued 


Request Block structure 


: 
: 
: : 


Reserved (initialize to 0000h) 


Interrupt Pending Status, where: 


Bit 7 = Reserved 

Bit 6 = 1 Periodic interrupt 
Bit 5 = 1 Alarm interrupt 
Bit 4 = 1 Update-ended 


interrupt 
Bits 3-0 = Reserved 


continued 
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Function: 0Bh — Set Alarm Interrupt, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description | 


0000h | + Successful Operation 
Never returned by this function. If it is present, the request 
for this function has not been processed. The Interrupt 
Pending Status indicates if an Update-Ended Interrupt 
| 000th Resume Stage after interrupt 
| 0005h_— Not My Interrupt, Resume Stage after Interrupt 


has been set. 
8000h Device in Use | 
8001h Real Time Clock Not Started 
8002h interrupt Already Enabled | | 
C000h Invalid Logical ID | : | | 


CO0th Invalid Function 
| C003h_—_—|_ Invalid Unit Number in a 


C004h Invalid Request Block Length 
FFFFh Return Code Field Not Valid | 
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Function: 0Ch — Cancel Alarm Interrupt 


Description 


This function is a single-staged request that disables the alarm interrupt. 
ABIOS disables NMis before performing this function. 


Request Block structure 


: 
: 
: 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Function: 0Dh — Set Periodic Interrupt 


Description 


This function is a multistaged request that sets the interval for the periodic 
interrupt. If the RTC is not functioning ABIOS does not perform this function, 
and generates Return Code 8001h RTC Not Started. ABIOS disables NMis 
when accessing system CMOS RAM. 


- Real time clock update cycle 


In the IBM PS/2 BIOS, if the real time clock is in an update cycle when this 
function is requested, Return Code 8000h Device Busy Request Refused is 
generated. The Phoenix BIOS aborts the clock update cycle and performs 
the function in this case. 


Setting the periodic interrupt : 
- The following steps must be followed to set the periodic function: 
1. If there is an outstanding Set Periodic Interrupt already enabled, function 
OEh Cancel Periodic Interrupt must be invoked before function ODh. 
2. Invoke function ODh Set Periodic Interrupt. 
Check the Return Code. 
4. If the Return Code is 000th, the Interrupt Pending Status field indicates 
the interrupt that occurred. 
5. Query the Return Code just one time; make sure that all indicated inter- 
rupts are processed sequentially. 


ey) 


Request Block structure 


[ortset| size |] inputs | outout 
Word 
: 
[Return Code 
oe [Word — 


continued 
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Function: 0Dh — Set Periodic Interrupt, Continued 


Bits 3-0= Rate value set 
0000b = None 
000ib = 30.517 ms 
0010b = 61.035 ms 
0011b = 122.07 ms 
0100b = 244.141 ” 
0101b = 488.281 ” 
0110b = 976.562 ” 
0111b = 1.953125 ms 
1000b = 3.90625 ms 
1001b = 7.8125 ms 
1010b = 15.625 ms 
1011b = 31.250 ms 


Request Block structure, cont’d 
1100b = 62.500 ms 
1101b = 125.00 ms 


ll 1110b = 250.00 ms 


Byte Perlodic Interrupt Rate, 
1111b = 500.00 ms 


Bits 7-4= Reserved 
| Reserved (initialize to 0000h) 


Byte [fe Interrupt Pending Status, where 
Bit 7 = Reserved 
Bit 6 = 1 Perlodic interrupt 
Bit 5 = 1 Alarm interrupt 
Bit 4 = 1 Update-ended 
interrupt 
oe Bits 3-0 = Reserved 


continued 
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Function: 0Dh — Set Periodic Interrupt, Continued 


Return Codes 
This list contains only the most common Return Codes for this function. Test 


all valid bits in the Return Code field to ensure proper performance. 
Never returned by this function. If it is present, the request 
for this function has not been processed. The Interrupt 
| 0001h Resume Stage after Interrupt: 
| 0005h Not My Interrupt, Resume Stage after Interrupt 
| 8002h Interrupt Already Enabled 
C000h Invalid Logical ID 
C004h Invalid Request Block Length 
| FFFFh Return Code Field Not Valid 


Description 
0000h Successful Operation 
: Pending Status indicates if an Update-ended interrupt 
has been set. 
8000h Device in Use 
800th Real Time Clock Not Started 
Co01h Invalid Function 
C003h Invalid Unit Number | 
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Function: 0Eh — Cancel Periodic Interrupt 


Description 


This function is a single—staged request that disables the periodic interrupt. 
ABIOS disables NMIs before performing this function. 


Request Block structure 


a 


[con | word || Request Block Length «di 
| 06h | Word || Function (O00Eh)  —ss—s——sdt 
Reserved (iniialze to 0000) || 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 
0000h Successful Operation | | 


[coos | watd Une Number 
[FrFEn [Return Code Fis Not Val 
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Function: 0Fh — Set Update-Ended Interrupt 


Description 


This function is a multistaged request that enables the update-—ended inter- 
rupt. The update-—ended interrupt generates an interrupt that is activated © 
every time the system clock is updated, or once per second. If the RTC is 
not functioning, ABIOS does not perform this function and generates Return 
Code 8001h RTC Not Started. ABIOS disables NMis when accessing system | 
CMOS RAM. 


Real time clock update cycle 


In the IBM PS/2 ABIOS, if the real time clock is in an update cycle when this 
function is requested, Return Code 8000h Device Busy Request Refused is 
generated. The Phoenix ABIOS aborts the clock update cycle and performs 
the function in this case. 


Request Block cannot be changed 


The Request Block field must not be changed during any intermediate stage 
of a request for this function. 


Setting the update-ended interrupt 
The following steps must be followed to set the update—ended function: 


1. If there is an outstanding Set Update-Ended Interrupt already enabled, 
function 10h Cancel Update—Ended Interrupt must be invoked before 
function OFh is invoked. 

2. Invoke function OFh Set Update-Ended Interrupt. 

. Check the Return Code. 

4. If the Return Code is 000th, the Interrupt Pending Status field indicates 
the interrupt that occurred. 

5. Query the Return Code just one time; make sure that all indicated inter- 
rupts are processed sequentially. 


Ww 


continued 
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Function: 0Fh — Set Update-Ended Interrupt, Continued 


Request Biock structure 


|Offset| size || inputs Outputs 
| 02h | Word 
: 


Reserved (initialize to 0000h) 


Byte 


Interrupt Pending Status, where: 


Bit 7 = Reserved 

Bit 6 = 1 Periodic interrupt 

Bit 5 = | Alarm interrupt 

Bit 4 = | Update-ended 
interrupt 

Bits 3-0 = Reserved 


| Eh | 
| 16h 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0000h Successful Operation 
Never returned by this function. If it is present, the request 
| for this function has not been processed. The Interrupt 
| 000th = Resume Stage after Interrupt 
| 0005h Not My Interrupt, Resume Stage after Interrupt | 
8000h Device in Use 


Pending Status indicates if an update-ended interrupt 
has been set. 

Invalid Unit Number 

Invalid Request Block Length 
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Function: 10h — Cancel Update-Ended Interrupt 


Description 


This function is a single-staged request that disables the Update—Ended 
Interrupt. ABIOS disables NMis before performing this function. 


Request Block structure 


| 00h | Word | Request Block Length 2 
| 02h | Word || Logical ID 7 


| 08h_| Word _ 
__—_ 
| OEh | Word {I _ 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


_Frren | Retumn Code Fos Not Valag C= 


464 | ABIOS for IBM PS/2 Computers and Compatibles 


Function: 11h — Read Time and Date 


Description 


This function is a multistaged request that reads the current setting of the 
real time clock. The output Time and Date fields are only valid if the Return 
Code is 0000h Successful Operation. ABIOS disables NMis before performing 
this function. If the RTC is not functioning, ABIOS does not perform this 
function and generates Return Code 8001h RTC Not Started. 


Note: Function 12h Write Date and Time must be called before this function 
is invoked. 


ABIOS test for update-—in-progress 


If the Return Code is 8000h Device in Use or 8001h Real Time Clock Not 
Started the real time clock is halted. This request is not processed until the 
real time clock is set. 


Request Block structure 


a a 


| 90h | Word || Request Block Length || 
[02h | Word |[ Logical ID 
| Word |] unit 
[06h [Word |{ Function (oo1thy 
| osh_| Word |[ Reserved (initialize to 0000h) |} 
| OAh | Word || Reserved (initialize too000h) 


[12h | ayte || |[ Alarm Hour in BCD (00-23) ‘| 
| 13h | Byte || 


||_Alarm second in BCD (00-59) 


Century in BCD, where: 
0 = 20th century 
1 = 21st centu 


|[_ Year in BCD (00-99) _ 
|[_Month in BCD (01-12) 


|| Day In BCD (01-31) 


Word 
Byte 
Byte 
Byte 
: 
| 18h | Byte 


continued 
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Function: 11h — Read Time and Date, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 
0000h Successful Operation 
8000h Device In Use 
8001h Real Time Clock Not Started 
1  cCo00h Invalid Logical ID 


Cooth Invalid Function 


C003h Invalid Unit Number 
C004h Invalid Request Block Length 


Return Code Field Not Valid 


Function: 12h — Write Time and Date 


Description 


This function is a single-staged request that starts the real time clock (if it is 
not already started) and sets the time and date information as specified. If 
the clock is already started, the clock update cycle is aborted, the new time 
and date are set, and a new clock update cycle is started. ABIOS disables 
NMis before performing this function. If the RTC is not functioning, ABIOS 
does not perform this function and generates Return Code 8001h RTC Not 
Started. 


Real time clock update cycle 


In the IBM PS/2 BIOS, if the real time clock is in an update cycle when this 
function is requested, Return Code 8000h Device Busy Request Refused is 
generated. The Phoenix BIOS aborts the clock update cycle and performs 
the function in this case. 


continued 
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Function: 12h — Write Time and Date, Continued 


Request Block structure 


| 02h | Word || Logical ID == sd 
word |[unt SSCS 
| 06h _ | Word |{ Function (0012h) sd 
oan | Word || Reserved (intiaize to 000m) | 
[oan | word || Reserved (intiaize to 000m) |] 
Return Code 
| 10h | Word || Reserved (initialize to 0000h) |} 
[72h_[ Byte || Hour in BCD (00-28) dt 


13h Byte Minute in BCD 
(00-59) | 

14h Byte Second in BCD | 
(00-59) : 

15h Byte Century in BCD, where: | 

0 = 20th century : 

1 = 21st century : 

Year in BCD (00-99) : 


17h_| Byte Month in BCD (01-12) , 
Day in BCD (01-31) _ 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Chapter 16 
ABIOS System Services 


Overview 


Introduction 


The ABIOS System Services provide functions that allow address mode 
switching, enable the system speaker, read system configuration informa- 
tion, and enable/disable Address Line 20. 


Summary of System Services functions 


Return Logical 1D Parameters 


th 

r 
06h | “Switch to Real Mods 
[ooh | “Enable Adress tne 20 


Disable Address Line 20 
Enable Speaker 


continued 
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Overview, Continued 


In this chapter 
In this chapter, the following topics are discussed: 
e Error Handling 
=» ABIOS System Services functions 


Error Handling 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. | 


If Bit 15 of the Return Code field is set, the System Services function re- 
quested has an error. The caller’s Return Code handler routine should then 
test Bits 14, 13, 12, and 8 to determine the class of error that has occurred 
and then test the remaining bits to determine the nature of the error. 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-—staged request that returns information about the 
specified Logical ID. 


Request Block structure 


a 


| 00h | Word _ 
[2h | Word — 
| 04h | Word _ 
| 08h | Word _| 


: 
‘|| Device ID (0009h) ee! 
Logical ID flags (0000h) 
Bits 15-4 = Reserved 


Bit 3 = 0 No overlap across 
units 

Bit 2 0 Reserved 

Bits 1-0 = Transfer Data Pointer 


Mode 
00 - Pointers 


: {| Request Block Length (for other 
: <1] functions) 
Reserved (initialize to 0000h) Secondary Device ID 


: Revision Level 
1Ch Reserved (initialize to 0000h) 
| 1Eh | Word | Reserved (initialize to 0000h) 


continued 
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Function: 0ih — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


FFFFh Return Code Field Not Valid 
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Function: 03h — Read System Configuration 


Description 


This function is a single-staged request that returns information about the 
configuration of this system. 


Processing 


ABIOS disables all interrupts, including NMIs while processing this request. 


identifying PS/2 models 


The following information about PS/2 model and submodel byte information is 
stored in the BIOS ROM data area (the motherboard ID can be read from the 
POS registers). These areas can be accessed from CBIOS. 


This information identifies various PS/2 models. It should not be used to 
determine processor type, CMOS RAM size, the number of adapter slots in a 
system, memory register use, or other system-specific data. The Feature 
Configuration Table contains the above data. 


Submodel Motherboard ID Description 
FEFFh Model 80 
FDFFh Model 70 


Any Other Value Unknown System Board 


continued 
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Function: 03h — Read System Configuration, Continued 


Request Block structure 


ee ae ae! 
| 00h | Word | Request Block Length 2 
| 02h | Word || Logical ID_ 

| 04h | Word _| 
| 06h | Word || Function (0003h 


| 08h | Word | Reserved (initialize to 0000h 


‘Base Memory in 1K Blocks 
Expansion Memory in 1K Blocks 


POS Slot 5 Configuration Byte for 
Channe | 
Copy of System Board POS 2 Slot 


Model Byte — set to FFh if the 
Adapter ID Is an unknown type. 


Submodel Byte — set to FFh if the 
Adapter !D is an unknown type. 


| 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[coon inva Function 
[C00 | inva Unt Number 
[c0oan [vali Request Bick Loree 
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Functions: 04h - 0Ah — Reserved 


Function: 0OBh — Switch to Real Mode 


Description 


This function is a single-staged or multistaged request that switches pro- 
cessing to the real mode of the 80286, 80386SX, or 80386 microprocessor 
and disables Address Line 20 to the microprocessor, which effectively denies 
access to any address above 1 MB. 


ROM BIOS Data Area pointer 


Data Pointer 0 in the real mode Common Data Area points to the ROM BIOS 
Data Area. 


Interrupts disabled during processing 


While processing this function, the ABIOS disables interrupts, including the 
NMI I/O Channel Check and Parity Check. The NMI Watchdog Timer Time-out 
and DMA Arbitration Bus Time-out cannot be disabled. 


Successful completion 


If all stages of the request are completed, the address mode of the proces- 
sor is switched to real mode and out of ABIOS. The caller should have set 
AH to a nonzero value before calling this function. ABIOS clears AH when 
this function is successfully completed. Upon successful completion of this 
function, control is returned to the caller at the location pointed to by the 
Resume Pointer Field. 


If AH is still a nonzero value, this function request has not been successfully 
completed. 


continued 
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Function: 0OBh — Switch to Real Mode, Continued 


Request between stages 


If the request is between stages, a Return Code of 0005h is present and 
none of the Request Block parameters are changed yet. 


Request unsuccessful 


If there is an invalid parameter in the request for this function (Return Code 
C0Oxh), ABIOS returns to the caller with the appropriate Return Code set. 
The caller must then process the error and request the function again. 


It is the caller’s responsibility to re-enable interrupts, including the NMI, upon 
return, either successful or unsuccessful, from a request for this function. 


Request Block structure 


| 02h | Word _| 
| 06h | Word | 
| 08h_| Word _ 
 ...... 
|ReturnCode 
| 0Eh | Word II. 
| 10h_| DWord | e 
| 60h | DWord || Resume Pointer 


Word Selector to a Dummy Descriptor 
Field | ss 


continued 
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Function: 0Bh — Switch to Real Mode, Continued 


Error handling 


This function does not update the Return Code Field unless there is an error 
in one of the input parameters. If there is an error in one of the input pa- 
rameters, the ABIOS returns with all registers preserved. Otherwise, this 
function jumps to the address that the Resume Pointer points to with all 
registers changed and only CS:IP and AH containing meaningful information. 


Set AH to a nonzero value before calling this function and then test AH for 
zero. A nonzero value indicates an error condition. See the System Services 
chapter in CB/OS for PS/2 Computers and Compatibles for more information 
on how to handle the error condition indicated in AH. 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Code Description 


0000h Successful Operation 

Not My Interrupt, Resume Stage after Interrupt 
Co000h 
Co0th 
C003h 
C004h 
FFFFh 


Invalid Logical ID 

Invalid Function 

Invalid Unit Number 

Invalid Request Block Length 
Return Code Field Not Valid 
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Function: 0Ch — Switch to Protected Mode 


Description 


This function is a single-staged request that switches processing to the 
protected mode of the 80286, 80386SX, or 80386 microprocessor and 
enables Address Line 20 to the microprocessor. 


Interrupts disabled during processing 


While processing this function, the ABIOS disables interrupts, including the 
NMI I/O Channel Check and Parity Check. 


The NMI Watchdog Timer Time-out and DMA Arbitration Bus Time-out cannot 
be disabled. 


Caller responsibilities 


The caller must have loaded the Global Descriptor Table and the Local 
Descriptor Table referred to in the Request Block before calling ABIOS. 
Selector 20h in the descriptor table references the caller’s code. 


continued 
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Function: 0Ch — Switch to Protected Mode, Continued 


Function completion 


Upon completion of this function, control is returned to the caller at the 
location pointed to by the Resume Pointer Field, with ABIOS having changed 
the contents of CS:IP to point to a protected mode location instead of a real 
mode location. 


Note: It is the caller’s responsibility to re-enable interrupts, including the 
NMI, upon return from this function. 


Request Block structure 


: 
: 
| Return Code 
LS 


: Segment Descriptor Table Base — 

1] (Bits 0-15) 

1} Segment Descriptor Table Base — 

||_ (Bits 16-23) 

|| Segment Descriptor Table Access 
Rights Byte 

1; Segment Descriptor Table Reserved 

| Bytes = 


Reserved (do not initialize 
Resume Pointer 
Reserved (do not initialize) 


continued 
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Function: 0Ch — Switch to Protected Mode, Continued 


Error handling 


This function does not update the Return Code Field unless there is an error 
in one of the input parameters. If there is an error in one of the input pa- 
rameters, the ABIOS returns with all registers preserved. Otherwise, this 
function jumps to the protected mode address pointed to by the Resume 
Pointer. | 


Return Codes 


480 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Code Description 


-0000h 


Successful Operation 
Co00h Invalid Logical ID 


Cooth Invalid Function 


C003h Invalid Unit Number 


C004h Invalid Request Block Length 
FFFFh Return Code Field Not Valid 
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Function: 0Dh — Enable Address Line 20 


Description 


This function is a single-staged request that enables Address Line 20 to the 
microprocessor, which permits access to any valid address above 1 MB. 


Request Block structure 


Request Block Length | 
Logical ID : 


Unit 


Function (OOODh : 


| Word | 
OAh , _ 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[e000 | vats togeal iO SSSCSC~S~S~S~S 
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Function: 0Eh — Disable Address Line 20 


Description 


This function is a single—staged request that disables Address Line 20 to the 
microprocessor, denying access to any address above 1 MB. 


Request Block structure 


fotteer| size || inputs Outputs 
Request Block Length S ase 
| 02h | Word | Logical ID 


| | Word || Unit__ | | 
| 06h _| Word _ 
| Reserved (initialize to 0000h) | 
| An | Word _| : 7 | 
| 0Ch | Word 


| 0Eh_[ Word _ | : : Se 
| 10h | DWord || Reserved (initialized to 0000h) Ee a 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


| code | Description 
[oooon | Succosstu peraion 
| coesh | trvate Unt Nurber 
[Fern | Return Code Feld Not Valo 
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Function: 0Fh — Enable Speaker 


Description 


This function is a single-staged request that enables the system speaker at 
the specified frequency for the specified duration upon successful comple- 
tion of this function. 


The system speaker is enabled by programming Mode 3 of System Timer 
Channel 2. 


Request Block structure 


| 00h | Word | Request Block Length 
| 02h | Word || Logical 1D 


Function (000Fh 


Reserved (initialize to 0000h) 
niet (initialize to 0000h) 


Word | Time-out 


Word rosuerey Divisor (1.19 MHz di- 
vided by the frequency = the | 
frequency divisor). 

Ex: The frequency divisor is 


1331, for a frequency of 886 Hz. 


Byte Duration Counter In sixty—fourths 
of a second 


[06h 

[An _| 

Pe | Wend 
OEh 


continued 
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Function: OFh — Enable Speaker, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0000h Successful Operation 
If either the input frequency or duration is zero, the func- 
| tion Is not performed and the Return Code is 0000h. 
C000h | Invalid Logical ID 
: Cooth | Invalid Function 
| C003h Invalid Unit Number 


a C004h Invalid Request Block Length 
FFFFh Return Code Field Not Valid 
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17 


Chapter 17 


ABIOS Nonmaskable Interrupt 
(NMI) Service 


Overview 


Introduction 


The ABIOS Nonmaskable Interrupt Service clears a nonmaskable interrupt at 
the NMI source, which is usually at the device level. 


Note: This service clears the source of the interrupt after the source of 
the NMI is logged, but does not re-enable NMIs. The caller must 
reenable NMIis. 


NMI processing 


A Nonmaskable Interrupt (NMI) occurs because an error condition exists 
somewhere in the system. 


continued 
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Overview, Continued 


Types of NMI 
The types of NMI are: 
=» System Board Memory Parity Check 
« Adapter Card (I/O) Channel Check 
=» Watchdog Timer Time-out 
= DMA Arbitration Bus Time-out 


Summary of Nonmaskable Interrupt Service functions 


Description 


oth Return cacicald iD Parameters 
[canon [Reseved 


Enable NMI 
Disable NMI 
NMI Continuous Read | 


In this chapter 


This chapter includes information about the following topics: 
» Error Handling 
» ABIOS Nonmaskable Interrupt Service functions 
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Error Handling 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


If Bit 15 of the Return Code field is set, the Nonmaskable Interrupt Service 
function requested has an error. The caller's Return Code handler routine 
should test Bits 14, 13, 12, and 8 for the class of error that has occurred 
and then test the remaining bits to determine the nature of the error. 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single—staged request that returns the parameters for the 
specified Logical ID. 


Request Block Structure 


feree ase [ese oes 
| 00h | Word || Request Block Length (20h) 
| 02h | Word |! Logical ID 


| 04m | Word |{ Unit 
| 08h | Word || Reserved (initialize to 0000h)__| 


| OEh | Word | | ne 
| 10h | Byte | Hardware Interrupt Level (FEh) 
| iih_ | Byte | Arbitration Level (FFh 
| 12h | Word _ Device ID (0009h) 
Count of Units (0000h) 
Word Logical ID flags (0000h) 
Bits 15-4 = Reserved 
Bit 3 = 0 No overlap across 
units 
Bit 2 = 0 Reserved 
Bits 1-O = Transfer Data Pointer 
Mode 
00 No Pointers 
Required 
| ae ee =1| Request Block Length (for other 
| | Se ee eee ee eT functions) 
Reserved (initialize to 0000h) Secondary Device ID 
| 1Bh | Byte 3 oe See =="211 Revision Level | 
Reserved (initialize to 0000h) ee 
| 1Eh | Word | Reserved (initialize to 0000h) 


continued 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Code 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Functions: 02h - 05h — Reserved 
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Function: 06h — Enable NMI 


Description 


This function is a single-staged request that enables the NMI for System 
Board Memory Parity Checks and Adapter Card I/O Channel Checks. 


Note: The ABIOS cannot enable the DMA Arbitration Bus Time-out and the 
Watchdog Timer Time-out NMis. 


Request Block Structure 


== = 


oar [ Wert 
ee 
[06h | Word — 
-—2h_|_ Word _ 
a eee: 
oh 
| 2th 


Word 
Ez 3 ee : | Bul anni 
es te 3 


Return Code 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Function: 07h — Disable NMI 


Description 


This function is a single—staged request that disables the NMI for System 
Board Memory Parity Checks and Adapter Card I/O Channel Checks. 


Note: The ABIOS cannot disable the DMA Arbitration Bus Time-—out and the 
Watchdog Timer Time-out types of NMIis. 


Request Block Structure 


| 02h | Word _| : 
| 04h | Word _| : 
[06h | Word _ : 
: 


0Ch_| Word || Return Code 


Reserved (initialize to 0000h) = ee Ae 


Return Code 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 
0000h Successful Operation 
Co00h Invalid Logical ID 
Cooth invalid Function 
C003h Invalid Unit Number . 


C004h Invalid Request Block Length 
FFFFh Return Code Field Not Valid 
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Function: 08h — NMI Continuous Read 


Description 


This function is a continuous multistaged request. It sets up a permanently 
resident Request Block which is used by the NMI hardware interrupt routine 
and the caller to handle NMis. 


eaves Block Structure 


EC a 


, 
: 
Word : L 

: : 
\| Type of NMI 


00h = Reserved 

O1h = Parity Check 

02h = Channel Check 

03h = DMA Bus Time-out 
04h = Watchdog Time-out 


: DMA Arbitration Level that Initiated 
the DMA Bus Time-out 


Slot Number that Initiated the I/O 
: 11 Channel Check 
Reserved (initialize to 0000h) S . 


continued 
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Function: 08h — NMI Continuous Read, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Code Description 
0000h Successful Operation 
| 000th Resume Stage after Interrupt 


[00s [Not My interrupt, Resume Stage after Interrupt 
Invalid Function 


ABIOS Nonmaskable Interrupt (NMI!) Service 493 


18 


Chapter 18 
ABIOS Pointing Device Service 


Overview 


Introduction 


The ABIOS Pointing Device Service provides routines to handle pointing 
devices. A mouse is the most commonly used pointing device, but this 
service also handies other devices such as trackballs and touchpads. 


Rep eae 


continued 
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Overview, Continued 


Summary of Pointing Device Service functions 


| Function — Description 


| 00h Default Interrupt Handler 


Return Logical iD Parameters 
[Reeved SCSC~C~CSCSC*d 
Read Device Parameters 


| 04h | Reserved 
| 05h | Reset/Initialize Pointing Device 


[aen-oan | Reserved 


Set Resolution 
| ODA Set Scaling Factor 


Read Pointing Device Identification Code 


In this chapter 


This chapter includes information about the following topics: 
« Hardware Environment 

e Error Handling 

» ABIOS Pointing Device Service functions 
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Hardware Environment 


The ABIOS Pointing Device Service is associated with hardware interrupt 
request 12. The ABIOS Pointing Device Service supports a Pointing Device 
and a Pointing Device/Keyboard Controller such as an appropriately pro- 
grammed Intel 8042 or its equivalent. 


Error Handling 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


lf Bit 15 of the Return Code field is set, the Pointing Device Service function 
requested has an error. The caller’s Return Code handler routine should test 
Bits 14, 13, 12, and 8 to determine the class of error that has occurred and 
then test the remaining bits to determine the precise nature of the error. 
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Function: 00h — Default Interrupt Handler 


— Description 


This function is a single-staged or multistaged request that handles unex- 
pected hardware interrupts by resetting the interrupt at the device level. 


When to invoke 


This function is invoked by calling the interrupt routine with a function code 
of Q00Oh. It is only invoked if a given Logical ID has no outstanding Request 
Blocks waiting for an interrupt. 


Request Block Structure 


jorteet| size || puts ff uteuts 
| 00h | Word _| , 
cen T-Werd— 

o8n|[-Word— 
| 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 


0000h Successful Operation 
| 0008h Not My Interrupt, Resume Stage after Interrupt 


[—e00an [vat unt Number SSCS” 
[—coodh [rata Request Sock Length 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns the parameters for the 
specified Logical ID. 


Request Block Structure 


| ooh | Word _ : : 
| 04h | Word | 
| 06h_| Word _| 
, 
OAh oo ae 

? pone | Scceee 


| 
, Device ID (000Bh) 
| Word || 


Logical ID flags (0000h) 
Bits 15-4 = Reserved 


Bit 3 = 0 No overlap across 
units 
Bit 2 = 0 Reserved 
Bits 1-O = Transfer Data Pointer 
Mode 


00 = No Pointers 
R ired 


cao =| functions) 
Byte || ee eee 


continued 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Function: 03h — Read Device Parameters 


Description 


This function is a single-staged or multistaged request that returns the 
Pointing Device Status for the specified Pointing Device. 


continued 
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Function: 03h — Read Device Parameters, Continued 


Request Block structure 


| 00h | Word || Request Block Length : 
| 02h | Word _| 


| 04h | Word _| 
— 98h} Werd_| -Lunation (90088) 0003h 
| Word _| Reserved | Reserved (initialized to 0000h) _| to 0000h 


i ; 
| ith 


1h 


+ 
er 


Return Code 


Interface Status, where: 


Bits 7-6 = Reserved 
Bit 5 = Interface enable 
0 Disabled 
1 Enabled 
Bits 4-0 = Reserved 


Data Package Size (00h-08h) 


Flag Word, where: 


Bits 15-7 = Reserved 
Bit 6 = Mode 

0 Stream mode 

1 Remote/poll mode 
Bit 5 = Status 

0 Disabled 

1 Enabled 
Bit 4 = Scaling 

0 1:1 Scaling 

1 2:1 Scaling 
Bit 3 = Reserved 
Bit 2 = Left button pressed 
Bit 1 = Reserved 
Bit 0 = Right button pressed 


Current Resolution, where: 


count per mm 

counts per mm 
counts per mm 
counts per mm 


ofhNM — 


10 reports/second 
20 reports/second 
40 reports/second 
ee reports/second 
1 
= 2 


0 reports/second 
00 reports/second 
00 reports/second 


Time to Wait (In microseconds) 
Le EE _Before Resuming Requests 


| Reserved (initialize to 0000h) | Reserved (initialize to 0000h) to 0000h) 


DWord 


wo 
QO 
zs 
Hun wn na 


continued 
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Function: 03h ae Read Device Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[000s | Not My Iterupt Resume Stage afer ermine | 


Function: 04h — Reserved 
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Function: 05h — Reset/Initialize Pointing Device 


Description 


This function is a single-staged or multistaged request that resets and initial- 
izes a Pointing Device. 


Pointing Device initialized state 
When the pointing device is initialized, 
» data package size is not changed, 
» resolution is set to 4 counts per millimeter, 
= sample rate is set to 100 reports per second, 
= scaling factor is set to 1:1, and 
» the pointing device is disabled. 


Using this function 


The steps below must be followed before this function can be used: 
1. invoke function 08h Continuous Read, 

2. invoke function O6h Enable Pointing Device, 

3. invoke function 05h Reset/Initialize Pointing Device, and 

4. invoke functions OBh, OCh, ODh, or OEh, as needed. 


continued 
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Function: 05h — Reset/Initialize Pointing Device, Continued 


Request Block Structure 


| 02h _ | Word _ 
| 04h | Word 
| 08h | Word | 
: 
| 0Eh | Word | | ||_Time-out 

| 10h | 
[1th _| Byte 
Hed Boal 


11 Time to Wait (in microseconds) 
|| Before Continuing Request 


‘Reserved (intiaize to 000m) [ 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[—en0ih [Resume Stage after interrupt 
[ocah [Resume Stage after Time Delay 
[each [Not My Interrupt, Resume Stage ater Interrupt 
Invalid Function 

Invalid Request Block Length 
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Function: 06h — Enable Pointing Device 


Description 


This function is a single-staged or multistaged request that enables the 
Pointing Device. 


Using this function 
The steps below must be followed before this function can be used: 


1. invoke function 08h Continuous Read, 

2. invoke function O6h Enable Pointing Device, 

3. invoke function O5h Reset/Initialize Pointing Device, and 
4. invoke functions OBh, OCh, ODh, or OEh, as needed. 


Request Block Structure 


| 00h | Word | Request Block Length : ES a eae 
| 02h | Word || Logical ID : 


| 06h_| Word || Function (0006h 
| 08h_| Word |{ Reserved (initialized to 0000h) |} 


Reserved (initialized to 0000h) _‘| |. : 
| ee ee 


4 Bytes 


: Time to Wait (in microseconds) 
1| Before Continuing Request 


Reserved (initialize to 0000h) : 


continued 
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Function: 06h — Enable Pointing Device, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. | 


Description 
0000h Successful Operation 


| 0001h Resume Stage after Interrupt 
| 0002h Resume Stage after Time Delay 


| o00sh [Net iy interapt, Resume Stage afer torupt 
Return Code Field Not Valid 
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Function: 07h — Disable Pointing Device 


Description 


This function is a single-—staged or multistaged request that disables a point- 
ing device. 


Request Block Structure 


| 00h | Word | 
| 02h | Word _| 
| 04h | Word _ 
[06h | Word _| 
| 
: , 


| OEh 
Mid Kessel 


Reserved (initialize to 0000h) E 


continued 
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Function: 07h — Disable Pointing Device, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


cooth | Resume stage after mierust 
[ocan | Resume stage after Tine Delay 
[cosh | Not my iterupt, Resume Stage afer nierupt 


FFFFh Return Code Field Not Valid | 
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Function: 08h — Pointing Device Continuous Read 


Description 


This function is a continuous multistaged request that reads a pointing device 
while the device remains disabled. 


When to use 


This function must be invoked before invoking any other Pointing Device 
Service function except function Oth. 


Using this function 


The steps below must be followed before this function can be used: 
1. invoke function 08h Continuous Read, 

2. invoke function O6h Enable Pointing Device, 

3. invoke function 05h Reset/Initialize Pointing Device, and 

4. invoke functions OBh, OCh, ODh, or OEh, as needed. 


continued 
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Function: 08h — Pointing Device Continuous Read, Continued 


- Request Block Structure | 


[02h | Word | 
|_o4h_| Word _ 
[06h | Word — 
| 08h | Word _ 
|_0Eh_| Word || 


Ml Data package Size, where: 
7B 


ee ee ae omen | Reserved (initialize to 0000h) si 


Bytes Pointing Device Data, where: 
BYTE 1 
Bit 7 = 0 No Y Data Overflow 
= 1 Y Data Overflow 
Bit 6 = 0 No X Data Overflow 
= 1 X Data Overflow 
Bit 5 = 0 Y Data Sign is Positive | 
1 Y Data sign is Negative 
Bit 4 = 0 X Data Sign Is Positive 
X Data re is Negative 
0 
1 Right Button Pressed 
1 Left Button Pressed | 
BYTE 2 = Pointing Device X Data 
BYTE 3 = Pointing Device Y Data 
BYTES 4-12 = Reserved 
Note: X and Y refer to standard 
ee ae X/Y grid coordinates. 


continued 
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Function: 08h — Pointing Device Continuous Read, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0009h Attention, Data Available, Resume Stage after Interrupt 
coo4h 


Functions: 09h - 0OAh — Reserved 
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Function: 0Bh — Set Sample Rate 


Description 


This function is a single-staged or multistaged request that sets the sample 
rate for a pointing device. 


Using this function 
Invoke the following functions in the order given to use this function: 
1. Function 08h Continuous Read 
2. Function 06h Enable Pointing Device 
3. Function 05h Reset/Initialize Pointing Device 
4. Function OBh Set Sample Rate 


Request Block Structure 


| 00h | Word _ ie BST CHo bh tpen nanan Reno tna ROD 
| 

: 
| 06h | Word _ | 
| 08h _| Word _| , 


OAh Reserved (initialized to 0000h) Se 


= 
Word Sample Rate, where: S 
OAh = 10 reports/second 
14h = 20 reports/second 
28h = 40 reports/second 
3Ch = 60 reports/second 
§0h = 80 reports/second 
64h = 100 reports/second 
C8h = 200 reports/second 


AY Time to Wait (in icroseconds| : 
“11 Before Continuing Request 


continued 
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Function: 0Bh — Set Sample Rate, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[o0oin [Resume Stage after nterupt 
[o002n | Resume Stage ater Time Deay 
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Function: 0Ch — Set Resolution 


Description 


This function is a single-—staged request that sets the resolution for a pointing 
device by specifying the desired resolution rate in the Sample Rate field at 
offset 12h in the Request Block. . 


Using this function 
Invoke the following functions in the order given to use this function: 
1. Function 08h Continuous Read 
2. Function 06h Enable Pointing Device 
3. Function 05h Reset/Initialize Pointing Device 
4. Function OCh Set Resolution 


Request Block Structure 


S S 
02h = 4 counts per mm 


7 Word Sample Rate, where: 
| 00h = 1 count per mm 
— IL 03h = 8 counts per mm 
DWord | f= || Time to Wait (in microseconds) 
| : || Before Continuing Request 


Oth = 2 counts per mm 
Reserved (initialize to 0000h) : 


continued 
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Function: 0Ch — Set Resolution, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[—caGin [Resume Stage afer iterupt 
[—sonsh [Not My intern, Resume Stage ater iierupt 
[socan [Two Consecutive Resende Found —SSC=*Y 
[—FFFEn | Return Code Ftd Not Vag 
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Function: 0Dh — Set Scaling Factor 


Description 


This function is a single-staged or multistaged request that sets the Scaling 
Factor for a pointing device by specifying the desired value in the Scaling 
Factor field at offset 10h in the Request Block. 


Using this function 


Invoke the following functions in the order given to use this function: © 


1. 


Function 08h Continuous Read, 


2. Function O6h Enable Pointing Device, 
3. 
4. Function ODh Set Scaling Factor. 


Function O5h Reset/Initialize Pointing Device, and 


continued 


516 


ABIOS for IBM PS/2 Computers and Compatibles 


Function: 0Dh — Set Scaling Factor, continued 


Request Block Structure 


| 00h | Word || Request Block Length e : 
| 02h _ | Word || Logical ID 


| 04h | Word |] unit 
| 08h _ | Word || Reserved (initialized to 0000h) 


Word || Time-out (Not valid unless Return 
: _Code is 0002h). 


Byte Scaling Factor, where: 
00h = Reserved 
Oth = Set to 1:1 
02h = Set to 2:1 


DWord 


Time to Wait (in microseconds) 

! Before Continuing Request =! 
| 1Ch | Word || Reserved (initialize to 0000h) : oe 
Retry Mode Enable (bit 5 on) 


[29h | Byte 

Zan _| Word 
[26h | Byte 
[30h | Byte 

3th 
[33h_| Word [ Keyboard Data Register (60h) 
[36h | Word 


Byte Pointer to Beginning of Request 
= Block Status Area (2Eh) 


continued 
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Function: 0Dh — Set Scaling Factor, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Code Description 
0000h Successful Operation 
Resume Stage after Interrupt 


Resume Stage after Time Delay 


C004h Invalid Request Block Length 
FFFFh Return Code Field Not Valid 
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Function: 0Eh — Read Pointing Device Identification Code 


Description 


This function is a single-staged or multistaged request that returns the 
Pointing Device Identification Code from the pointing device/keyboard 
interface. 


Using this function 


Invoke the following functions in the order given to use this function: 


1 


Function 08h Continuous Read, 


2. Function O6h Enable Pointing Device, 
3. 
4. Function OEh Read Pointing Device Identification Code. 


Function 05h Reset/Iinitialize Pointing Device, and 


continued 
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Function: 0Eh — Read Pointing Device Identification Code, 
Continued 


Request Block Structure 


[02h | Word 
[06h | Word 
| 08h_| Word _| 
| _OCh_| Word _ 
: 


Not valid unless Return Code is 
0002h. 


"11 Time to Wait (in microseconds) 
=| Before Continuing Request 


Device ID 
Keyboard Data Register (60h) 


8042 Status Register (64h) 


Pointer to Beginning of Request 
Block Status Area (2Eh) | 


continued 
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Function: 0Eh — Read Pointing Device Identification Code, 
Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[o0o%n | “Resure Stage aforiernpt 
[sooar [Resume Saas ater Tine Dea 


| 0005h Not My Interrupt, Resume Stage after Interrupt 
8000h Device in Use 


[coos | vats Request locktorath—SSSCSCS*~*~*«* 
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1g 


Chapter 19 
ABIOS CMOS RAM Service 


Overview 


Introduction 


The ABIOS CMOS RAM service provides access to battery-backed CMOS 
memory. In addition, this service provides error checking through the 
Recompute Checksum function. 


Summary of ABIOS CMOS RAM Service functions 


Return Logical ID Parameters 


ean-am | Reserved SSS 
[een | Write wo cmos RAW 


continued 
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Overview, Continued 


In this chapter | 
This chapter includes information about the following topics: 
» Hardware Environment 

CMOS RAM Data Definitions 

Extended CMOS RAM Data Definitions 

Error Handling 

ABIOS CMOS RAM Service functions 


Hardware Environment 


Introduction 


Information may be stored in two areas of CMOS RAM. The table below 
describes the CMOS RAM areas. 


Table of CMOS RAM areas 


| 1/0 


CMOS RAM | 070h & 071h | 64 Bytes | These bytes are located on the Motorola 
Data Area MC146818A Real Time Clock CMOS chip 
| (or its equivalent). All implementations of 
the BIOS make use of this area to store 
real time clock, POST, and system con- 
figuration data. 


Extended 074h, 075h, 2048 When implemented on systems that em- 
CMOS RAM | and 076h Bytes ploy more than four adapter slots, the 
Data Area BIOS requires an additional 2K of CMOS 
| RAM. This extended CMOS RAM is pri- 
marily used to store POS data. 
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CMOS RAM Data 


Introduction 


The Motorola MC146818A Real Time Clock CMOS chip (or its equivalent) 
contains 50 bytes of CMOS RAM data. Addresses OOh-ODh access Real Time 
Clock data, which are listed in Chapter 15. Addresses OEh-3Fh access 
CMOS RAM data and are documented in this chapter. 


CMOS RAM Definitions 


The CMOS RAM data contained in the MC146818A chip is accessed by both 
the ABIOS and the CBIOS. CMOS RAM definitions are listed here for the 
convenience of ABIOS users. This information is repeated in CB/OS for IBM 
PS/2 Computers and Compatibles. 


Note: CMOS RAM locations 19h-30h are defined only for PS/2—Compatible 
models containing four or fewer adapter slots. 


Configuration data definitions 


The system configuration information data definitions use CMOS RAM ad- 
dresses OEh-3Fh. They are: 


1 Byte Diagnostic status, where: 
Bit 7 = 1 Real time clock lost power 
Bit 6 = 1 CMOS RAM checksum is bad 
Bit 5 = 1 Invalid configuration information found 

at POST 

Bit 4 Memory size compare error at POST 
Bit 3 Fixed disk or adapter fails initialization 
Bit 2 CMOS RAM time found invalid 
Bit 1 Adapters do not match configuration 
Bit 0 Time-out reading an adapter ID 
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nu wou 
ak ek eh ek ok 


= Power on or soft reset 
Oih = Memory size pass 

02h = Memory test pass 

O3h = Memory test fail 

04h = POST end; boot system 

05h = JMP DWord pointer with end-of-interrupt 
O6h = Protected tests pass 

07h = Protected tests fail 

O8h = Memory size fail 

O9h =INT 15h Block Move 

OAh = JMP DWord pointer without end-of-interrupt 
OBh = Used by ABIOS 


continued 


CMOS RAM Data, Continued 


Configuration data definitions, cont’d 


1 Byte Type of Diskette Drives: 
Bits 7-4 = Drive type of drive 0, where: 
| 0000b = No drive 
0001b = 360K drive 
0010b = 1.2 MB drive 
0011b = 720K drive 
0100b = 1.44 MB drive 
Bits 3-0 = Drive type of drive 1, where: 
0000b = No drive 
: 0001b = 360K drive 
0010b = 1.2 MB drive 
0011b = 720K drive 
0100b = 1.44 MB drive 


pA 1 Byte Type of fixed disk drive 1 | 


1 Byte Password Configuration 


Bits 7-5 = 0 Reserved 
Bit 4 = 0 BIOS initializes keyboard to normal 


speed 
1 BIOS initializes keyboard to fast speed* 
Bits 3-2 = Reserved 


Bit 1 = 1 Network password installed 
0 Network password not installed 
Bit 0 = 1 Power-on password installed 


0 Power-on password not installed 


Equipment installed, where: 


| Bits 7-6 = Number of diskette drives, where: 
00b = 1 Diskette drive 
01b = 2 Diskette drives 
Bits 5-4 = Primary display, where: 
00b = Reserved 
01b = VGA in 40-column mode 
10b = VGA in 80-column mode 
11b = VGA in monochrome mode 
Bits 3-2 = Reserved 
Bit 1 = | 80387 installed 
Bit O = 0 Diskette drive installed 


* If the machine has extended CMOS RAM, the value for the fast speed is taken from 
offset 702h. 


continued 
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CMOS RAM Data, Continued 


Configuration data definitions, cont’d 


Description 


Miscellaneous information 


Bits 7-4 = Actual number of RS-232 ports installed 
Bits 3-0 = sane move status before reset to real 
mode 


continued 
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CMOS RAM Data, Continued 


Configuration data definitions, cont'd . 


[smn | tr evie | Low byte of actual xpancion memory ze 
[sen | re vte | ah byte of actual expansion memory ee 
TTeve | Power-on password cheawum 


Extended CMOS RAM Data 


introduction 


The BIOS uses an additional 2K of CMOS RAM to store Programmable Option 
Select (POS) data for MCA-compatible computer systems that include more 
than four expansion slots. Fixed disk parameter data for fixed disks other 
than those listed in the ROM BIOS Fixed Disk Parameter Table is also stored 
in this additional CMOS RAM. 


Extended CMOS RAM data definitions 
The table below outlines the contents of the extended CMOS RAM data area. 


a ee 
Offset Description 

[eo00h | 1 8yte | LSB of adapter ID for chammelO 
| 00th] Byte | _MSBofadapter ID for channelO 
[ooczh | 1 eyte | Number of POS vauee used 
[e00sn | tByte | POS? for chamel0 
[e005 | tye | POSAtorchanmelO 


continued 
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Extended CMOS RAM Data, Continued 


Extended CMOS RAM data definitions, cont’d 


CMOS RAM 
Offset Description 


[—ooaah | tevte | POS Stor channel? SC 
| ooza-oogsh | | sReserved 
| ooao-oo6sn | | ~Reserved 
| oovo-oossh_ | | sReserved 
Number of POS values used 


continued 
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Extended CMOS RAM Data, Continued 


Extended CMOS RAM data definitions, cont’d 


a 
Offset Description | 

| oooth | eyte | Pos4torchannl4 
1 Byte MSB of adapter ID for channel 5 


1 Byte POS 3 for channel 5 | 
1 Byte POS 4 for channel 5 


1 Byte POS 5 for channel 5 | | | 


0093-00AEh 
OOAFh 
0OBOh 
OOBth 
00B2h 
0OB3h 
00B4h 
0OBSh 

OOB6-00D1h 


CReeved SCS 


1 Byte POS 5 for channel 6 


1 Byte | LSBof adapter ID forchannel7 
1 Byte MSB of adapter ID for channel 7 | 


1 Byte POS 5 for channel 7 


Reserved . 


continued 


00D4h 


00D6h 

00D7h 

00D8h 
00D9-00F4h 


0OF7h 
OOF8h 
OOFS9h 
OOFAh 
OOFBh 
OOFC-0160h 
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Extended CMOS RAM Data, Continued 


Extended CMOS RAM data definitions, cont’d 
CMOS RAM 


Offset ae Description 
0161-0162h 1 Word Set to a value to make POST’s CRC for extended 
CMOS RAM locations 0-162 equal zero. Maintained 
by the Reference Diskette. 


0163-0165h Actual extended memory size when over 65 MB 


0166-0175h 16 Bytes Fixed Disk Parameter Table for drive 0 
0176-0185h 16 Bytes Fixed Disk Parameter Table for drive 1 


0186h 1 Byte POST uses this offset to test whether extended 
CMOS RAM can be accessed correctly 
0189h-018Dh | = —_—si|_- Reserved for reference diskette POST use 


03B2h 20 Bytes Error Log Block 2 
03C6h 20 Bytes Error Log Block 3 


O3DAh 20 Bytes Error Log Block 4 
20 Bytes Error Log Block 5 


018Fh-0388h 
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Error Handling 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


If Bit 15 of the Return Code field is set, the CMOS RAM Service function 
requested has an error. The caller’s Return Code handler routine should test 
Bits 14, 13, 12, and 8 for the class of error that has occurred and then test 
the remaining bits to determine the nature of the error. 


Error checking 


532 


The potential for error inherent in CMOS technology makes error checking 
advisable. Test the Return Code field after all CMOS RAM Service function 
requests. A defective battery causes Return Code 80FFh, CMOS RAM Bat- 
tery Bad, and a checksum error causes Return Code 80FEh, CMOS RAM 
Checksum Invalid, but other Return Code values may occur. 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns the parameters for the 
specified Logical ID. 


Request Block Structure 


Request Block Length (20h) os 
|_02h_ | Word || Logical ID 


| 06h | Word _| 
. : 


| 0Eh | Word _ SS 
| 10h | Byte | Hardware Interrupt Level (FFh) 
Arbitration Level (FFh 


| iih | Byte 
Device ID (OOOEh) 


| 12h | Word _| 
Count of Units 


Word Logical ID flags 
Bits 15-4 = Reserved 
Bit 3 = 0 No overlap across 
units 
= 1 Overlap across units 
supported 
Bit 2 = 0 Reserved 
Bits 1-0 = Transfer Data Pointer 
Mode 
01 = Logical Pointer 
Required 
eal Word =1| Request Block Length (for other 
=1{ functions 


~ Reserved (initialize to 0000h)_ Secondary Device ID 
| Bh | Byte = |[_Revision Level 
Reserved (initialize to 0000h SESS 


| 1Eh | Word |} Reserved (initialize to 0000h) a 


continued 
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- Function: 01h — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Function: 02h — Reserved 


Function: 03h — Read Device Parameters 


Description 


This function, a single-staged request, returns the CMOS RAM Service 
device parameters. Specifically, the Read Device Parameters function returns 
the locations of extended CMOS RAM available to the user. The remaining 
areas of Extended CMOS RAM and all of CMOS RAM are reserved. 


continued 
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Function: 03h — Read Device Parameters, Continued 


Request Block Structure 


| 0Eh | Word | 

| 16h | Word _| : 
. 
L _ 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[e000 | Successta Operation 
CMOS RAM Battery Bad 


Co005h Invalid CMOS RAM Parameter 
FFFFh Return Code Field Not Valid 


Functions: 04h - 07h — Reserved 
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Function: 08h — Read CMOS RAM 


Description © 


This function, a multistaged request, returns the data stored in the CMOS 
RAM location pointed to by Data Pointer 1 or 2. The Transfer Data Pointer 
Mode, which determines the Data Pointer fields format, is returned in func- 
tion 01h, Return Logical ID Parameters function. 


Note: ABIOS disables nonmaskable interrupts while processing CMOS RAM 
accesses through functions O8h or O9h. 


Request Block Structure 


| 00h | Word | 
[02h [Word — 
Word 


OEh | Word | 


| 10h | Word || Reserved (initialize to 0000h) 


| 12h | DWord || Data Pointer 1 (Logical Pointer) 
| 16h | Word || Reserved (initialize to 0000h) 
Bit 0 = RAM type 
If field value = 0, no action is 


|_1Ah | DWord 
Z 0 CMOS RAM 


Word Flag Word, where: 
1 Extended CMOS 
| RAM 


Bit 15 = 1 NMI disabled 
Word Starting Address 


Bits 14-1 = Reserved 
Number of bytes to transfer: 


taken; Return Code field Operation 
Completed successfully is set. 


continued 
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Function: 08h — Read CMOS RAM, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Code Description 


Co0o5h Invalld CMOS RAM Parameter 


This field is set and no action is taken If the bytes in the 
Number of Bytes to Transfer field plus the byte count for 
the Starting RAM Address field in the Request Block is 
greater than the maximum amount of RAM. It could also 
mean that there is no Extended CMOS RAM. 


|  FFFFh Return Code Field Not Valid 
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Function: 09h — Write to CMOS RAM 


Description 


This function, a single-staged request, writes the number of bytes of data 
specified at offset 24h and pointed to by Data Pointer 1 or 2 to the CMOS 
RAM or extended CMOS RAM location specified at offset 22h, Starting Ad- 
dress. The Transfer Data Pointer Mode, which determines the Data Pointer 
fields format, is returned in function 01h, Return Logical ID Parameters 
function. 


Note: ABIOS disables nonmaskable interrupts while processing CMOS RAM 
accesses through functions 08h or O9h. 


Request Block Structure 


a 


| 02h _ | Word : 
Word 
| 06h | Word _ : 
| 
[12h | Word 
| 16h | Word | 
TReseved Cd 


Word Flag Word, where: 
Bit 15 = 1 NMI disabled 
Bits 14-1 = Reserved 
Bit 0 = RAM type 
0 CMOS RAM : 
1 Extended CMOS RAM ]§: 


|_22h_| Word __|| Starting Address 


aye Number of bytes to transfer: If field 


value = 0, no action is taken and the 
Return Code field Operation Com- 
pleted Successfully is set. 


continued 
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Function: 09h — Write to CMOS RAM, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


CO005h invalid CMOS RAM Parameter 


This field Is set and no action is taken if the bytes in the 
Number of Bytes to Transfer field plus the byte count for 
the Starting RAM Address field in the Request Block is 
greater than the maximum amount of RAM. It could also 
mean that there is no Extended CMOS RAM. 


FFFFh Return Code Field Not Valid 


Function: 0Ah — Reserved 
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Function: 0Bh — Recompute Checksum 


Description 


This function recomputes the checksum for either CMOS RAM or extended 
CMOS RAM. | 


When to Use 


Invoke this function following a function 08h, Read CMOS RAM or O9h, Write 
to CMOS RAM request. 


Request Block Structure 


a rs 
I 

Unit : 

| 06h _ | Word _ 

: 

OA : 

T10n | Wore : 


Flag Word, where: 


Bit 15 = 1 for NMI disabled 
Bits 14-1 = Reserved 


1 Extended CMOS 
RAM 


continued 
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Function: OBh — Recompute Checksum, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Chapter 20 


ABIOS Direct Memory Access 
(DMA) Service 


Overview 


Introduction 


Tne ABIOS Direct Memory Access (DMA) Service allows programs to allocate 
arbitration levels and DMA channels, and initiate transfers through the ABIOS. 
It is unnecessary for the caller to program the DMA Controller directly. 


DMA transfer operation steps 
To complete a DMA transfer, the caller must 
1. Receive an arbitration level by invoking function OBh, Allocate Arbitration 
Level. . 


2. Complete the Mode Control field (offset 1Ch in the Request Block) and 
the Transfer Control Bytes fields (offsets 1Dh and 1Eh in the Request 
Block) to specify the DMA controller functions for the request. 


3. Prepare for a transfer to or from a device, using functions 10h, 11h, or 
12h, by coding the appropriate input information. 


4. Disable the arbitration level (function ODh Disable Arbitration Level). 
5. Deallocate the arbitration level (function OCh Deallocate Arbitration Level). 


continued 
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Overview, Continued 


Summary of ABIOS DMA Service functions 


[0mm | etumn Logcalib Parameters 
[oan [Reeves 
[och | Alocate avbivatin tev 
[00h [ Disable Ariraton Lever 
[06h [BMA Transfer Status 
[ven [Abort OMA Operation 
=a 
Pim 
| ah 


DMA Transfer from Memory to I/O 
Read from |/O and Write to Memory 
Load DMA Controller Parameters 


In this chapter 
The following topics are discussed in this chapter: 


» Hardware Environment 
* Error Handling — | 
# ABIOS DMA Service functions 
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Hardware Environment 


DMA functionality 


The hardware environment for DMA transfers is described here in order to 
explain the background against which the DMA ABIOS functions operate. The 
ABIOS, however, serves as a shield between underlying hardware and re- 
quests of the operating system, eliminating the need for the caller to access 
the DMA controller directly. 


Direct Memory Access (DMA) allows large amounts of data to be transferred 
from a physical device to system memory or vice versa without micropro- 
cessor involvement. A program may initiate a DMA transfer and have no 
need to copy each byte or word individually, freeing the processor for more 
complex tasks. DMA transfers are typically from/to a fixed |/O port address 
to/from a continually incremented memory address. 


DMA functionality in Micro Channel systems is a superset of the functionality 
of two Intel 8237 DMA Controllers, one addressed at every port, starting with 
Port O000h, and one addressed at every other port, starting at port OOCOh. 
Access to 8237-compatible DMA functions and to additional functions for all 
channels is provided at I/O ports 0018h and 001Ah. Data output to port 
0018h selects the channei and function, and data output to or input from 
001Ah goes to or from the selected internal register. 


Bus sharing 


The system microprocessor and any currently-transferring DMA users can 
share the bus by taking turns directing bus cycles (driving the Micro Chan- 
nel’s address lines and certain control signals). An arbitration process deter- 
mines which of these possible bus masters is ready to direct a cycle. Com- 
peting bus masters (DMA devices) are assigned varying priorities, which are 
weighed during arbitration. Each bus master gets control of the bus for a 
number of cycles as determined by the arbitration process. 


DMA device 


A DMA device (or bus master) is one that enters into arbitration for the 
channel. If it wins, it receives addresses and control signals from the DMA 
controller so it can read or write data. 


continued 
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Hardware Environment, Continued 


DMA Controller 


A DMA controller is a device that monitors the arbitration process and gives 
addresses and control signals to the device that won the bus through arbitra- 
tion. The controller does not enter into the arbitration itself. PS/2—compatible 
Micro Channel—based systems provide a DMA controller that supports DMA 
transfers to/from up to eight devices at once. 


DMA hardware registers 
The DMA controller maintains several hardware registers for each DMA 
channel. The key registers are: 
= a memory address where the next byte or word will be transferred to or 
from, 
=» a count of the remaining bytes to transfer ((transfer count), 


=» a flag (mode) controlling the transfer direction (to memory or to the 
device), and 


» transfer status flags for each channel (status). 


DMA hardware registers 
The DMA Controller has ten sets of registers, summarized below: 


nie | Pay , | of | iii | 
Register | Registers How Allocated 

| Memory Address | 24 | 8_—s| st perChannel 
| WO Address | 8 | 1 PerChannel 
|_Temporary Holding 


| | 4 for Channels 7-4 
1 for Channels 3-0 
ae ae ee 


1 for Channel 4 
1 for Channel 0 


a [per Chane 
i a 1 for Channel 7-4 
| 1 for Channel 3-0 
ro 
ean Ba 


All Channels 
Independent of DMA 


continued 
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Hardware Environment, Continued 


Mode Control Field 


The Mode Control field provides an opportunity for the caller to use the 
Autoinitialization and Programmed I/O (PIO) features of the DMA Controller. 


= Autoinitialization 


Specifies if the DMA Controller will initialize automatically when the transfer 
reaches the terminal count. 


= Programmed I/O 


Specifies that the I/O address is to be programmed to the DMA Control- 
ler, driving the !/O address on the bus during the DMA cycles. 


Transfer Control Bytes 


These fields provide an opportunity for the caller to specify the physical 
address of the memory and |/O fields for ABIOS DMA Service functions 10h, 
11h, and 12h. 


= Count Control 


Specifies if the physical address is decremented or incremented during a 
transfer. 


= Device Size 
Specifies whether this is an 8—-bit or 16-bit transfer. 


Microprocessor and DMA 


It is possible for the microprocessor to address the DMA controller and 
access the DMA registers. The microprocessor can control the DMA modes, 
transfer addresses, transfer counts, channel masks, and page registers. 


Direct DMA Controller access 
Reading directly from or writing directly to any DMA Controller port may cause 
unpredictable results. 


continued 
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Hardware Environment, Continued 


DMA data transfer 


After a DMA device wins the arbitration bus and the DMA controller is pro- 
grammed to service the request, a transfer can take place. 


DMA transfers can be: 
= single transfer, 


= multiple transfer (burst mode), or 
=» read verification. 


Burst mode 


Burst mode is a method of DMA transfer that allows a device to remain 
inactive for long periods and then send large amounts of data in a short 
time. Some peripheral devices, e.g. a fixed disk, transfer their data in bursts 
that are frequently separated by long periods of inactivity. Burst mode is a 
way of making these devices more efficient. The device asks to be serviced 
only when it has data to transfer and then does so in large quantities. 


Arbitration process 


Arbitration is a process through which devices compete for control of the 
Micro Channel on a prioritized basis. Arbitration is organized in levels of 
priority, and on each level there can be a number of competing devices. 


continued 
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Hardware Environment, Continued 


Arbitration levels 


Arbitration levels are predefined or programmable levels of priority assigned 
to devices that compete for possession of the channel. 


Central Arbitration Control is a hardware function that allows intelligent pe- 
ripherals to share and control access to the system. 


Arbitration Levels are numbered from OOh to OFh, and include -1, and —2. In 
addition, there are Arbitration Levels -—1 and -—2, which exist only on the 
system board. Of the former set, Arbitration Level OOh has the highest 
priority; Level OEh has the lowest. All arbitration level priorities are assigned 
sequentially; OOh through OEh are the highest through lowest priorities. Level 
OFh is reserved for use by the microprocessor. 


The ABIOS DMA Service reads the fixed disk arbitration level from the CBIOS 
extended data area at ABIOS initialization and uses this arbitration level 
throughout the ABIOS session. 


continued 
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Hardware Environment, Continued 


Arbitration levels table 


The following table summarizes the arbitration levels: 


Arbitration Levels Primary Assignment 


a 


[00 [Reserved SSCS 


* These DMA Channels can be programmed to any arbitration level 


ABIOS functions allow these arbitration levels to be allocated, deallocated or 
disabled (except levels -1, -2, and OFh, which are permanently allocated). 


continued 
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Hardware Environment, Continued 


DMA channel flags 
Additional channel flags control whether 


= a transfer is to be repeated forever, 


» the memory address is to be decremented or incremented after each 
cycle, 


#» the DMA controller maintains I/O address (this is hardwired in most de- 
vices that use DMA), or 


=» a byte or a word is transferred at each cycle. 


Physical and Virtual DMA channels 


DMA channels can be either physical or virtual. A physical channel can only 
have one arbitration level, but a virtual channel can be programmed to own 
any arbitration level not currently assigned to a different channel. Thus, a 
virtual DMA channel can have many arbitration levels. 


Functionally, there is no difference between physical and virtual channels. 
Priority is determined by the arbitration level only, where level OOh is the 
highest priority and level OEh the lowest. 


Virtual DMA Channels and the Arbus register 


The arbitration level assignment for channels 0 and 4 can be programmed 
using the two 4-bit Arbus registers. The Arbus registers permit dynamic 
reassignment of the arbitration ID value by which the DMA controller re- 
sponds to DMA requests for bus arbitration. Channels 0 and 4 can then 
service devices at any arbitration level. 


DMA channels 


See Section 2 for a complete list of I/O port addresses for DMA channels. 
The DMA channel addresses are from O000h-001Fh and from O080h-O0DFh. 


continued 
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Hardware Environment, Continued 


DMA extended mode 


An extended mode register is available for each programmable DMA channel 
and is used when a DMA channel requests a DMA data transfer. DMA chan- 
nels must match the transfer size of the DMA slave, which is programmed 
by Bit 6 of the extended mode register. DMA read transfers of 16 bits from 
8-bit memory or 8-bit memory-mapped I/O devices are not supported. 


The following table describes the DMA extended mode register: 


Bit Number Description 


= 0 Reserved 


= 0 Reserved 


= 0 Read memory transfer 
= 1 Write memory transfer 


0 I/O address 00h 
1 User programs the I/O address 


Error Handling 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 


each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


If Bit 15 of the Return Code field is set, the DMA Service function requested 
has an error. The caller’s Return Code handler routine should then test Bits 
14, 13, 12, and 8 to determine the class of error that has occurred and then 
test the remaining bits to determine the precise nature of the error. 
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Function: 0ih — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns information about the 
specified Logical ID. 


Request Biock Structure 


: 


Hardware Interrupt Level (FFh) 
Arbitration Level (FFh 


Device ID (O00Fh) 


Count of Units (0001h) : 


Logical ID Flags 


Bits 15-4 = Reserved 
Bit 3 = 0 No overlap across 
units 
= 1 Overlap across units 
supported 
Bit 2 = 0 Reserved 
Bits 1-0 = Transfer Data Pointer 
Mode 
00 = No Pointers 
Required 


SS z= functions) 
Reserved (hitialze to 0000h) ——]P 
: 


continued 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[FFF | Return Code Fd Not Vale 


Function: 02h — Reserved 
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Function: 03h — Read Device Parameters 


Description | 


This function is a single-staged request that returns the DMA Parameters for 
the specified Logical ID and Unit. 


Request Block Structure 


— | 
| o4n | Word _| 
[sh | Word 
| osh_| Word | 


Maximum DMA Transfer Size in 
Kilobytes 


Number of Arbitration Levels 
Number of DMA Channels 


; Reserved (initialize to 0000h) 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Functions: 04h - 0Ah — Reserved 


Function: OBh == Allocate Arbitration Level 


Description 


This function is a single-staged request that allocates an arbitration level. 
The Allocate Arbitration Level function can be used to exclude other well- 
behaved tasks from using this Arbitration Level while a DMA transfer is 
performed. Valid arbitration levels are OOh through OEh. OFh is reserved. 


Request Block Structure 


[oreei] sue [mow owe 


| 02h | Word || Logical ID —CidzC 

: : 
CRetum Code 
[ten] Word || Reserved (intiaize to 0000n) 


continued 
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Function: 0Bh — Allocate Arbitration Level, continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Function: 0Ch — Deallocate Arbitration Level 


Description 


This function is a single-staged request that frees an arbitration level and its 
associated DMA channel so another task can use it. 


Request Block Structure 


| 00h _ esatetetstatstalstesntatetofatacotatitatatetetatetoleletntclaticecatecetslatetccelste aletelatelaceigtatalitets!ttatstatetatelaleriteletatstatatat tetetetet 
| 02h _ | Word | 
oan | Word _| 
| 06h | Word | | 

oan] Word 
oe 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description 


[e004 | Tova Request Block Length SSCSC~SCS 
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Function: 0Dh — Disable Arbitration Level 


Description 


This function is a single-staged request that disables the specified arbitration 
level for the specified device. It may be called after a DMA transfer is 
complete. 


Request Block Structure 


[oon | Word 

| 02h_ | Word : 
oan |_Word 
Te 


Function (000Dh : 
| Word || Reserved (initialize to 0000h 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


a 
[—vocon | Success Operaton SS 
[FFF | Ret Code Fld Not Valé 
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Function: 0Eh — DMA Transfer Status 


Description 


This function is a single-staged request that returns the number of bytes that 
remain to be transferred from the DMA controller. 


Request Block Structure 


a 


| 00h | Word | Request Block Length a 
| 02h _| Word | Logical ID 


| 04h | Word || Unit | 

|_ 06h | Word _ 
| 08h_| Word _ 
oo 
|_ 16h | Word | Le : 


18h DWord ||: Number of Bytes Still to be 
| : Transferred 7 


| 1Fh | Byte || Arbitration Level to Check ee 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[eccon | Succeseta Operation ——SSSOSCS~S 
[coos | vat une Number 
ee) 


FFFFh Return Code Field Not Valid 


560 ABIOS for IBM PS/2 Computers and Compatibles 


Function: 0OFh — Abort DMA Operation 


Description 


This function is a single-staged request that disables a DMA operation on an 
arbitration level and returns the number of bytes to be transferred and the 
address of the bytes to be transferred. 


Request Block Structure 


Fe 


on [| wor | Reaect aoa lean) : 

| 02h | Word || Logical ID 

| 04m | Word |] unit 
R 


| 06h __ 
| OEh_| 


s : 


DWord 


18h DWord 


1Fh Byte Arbitration Level to Abort the S 
Operation On S 


continued 


ABIOS Direct Memory Access (DMA) Service | 561 


Function: 0Fh — Abort DMA Operation, Continued 


Return Codes 


562 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


-8005h No Transfer in Process 
Co000h Invalid Logical ID | 


[c00sh | wal Unt Number 
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Function: 10h — DMA Transfer from Memory to VO 


Description 


This function is a single-staged request that programs the DMA controller 
with the values specified in the Request Block and transfers the specified 
number of bytes from the specified memory location to the specified I/O 
port address (0018h or 001Ah). 


Request Block Structure 


(a 


ord Request Block Length eee ee 
Logical !D 


. 
| OEh_ | Word _| 
| 10h | DWord || Physical Address of Memory : 
| 14h | 


Physical Address of |/O 


Mode Control, where: 


Bits 7-3 = Reserved 
Bit 2 = Programmable |/O 
Bit 1 = Reserved 

Bit 0 = Auto initialization 


Transfer Control Byte 1, where: 
Bits 7-3 = Reserved 


Bit 2 = Count control! 
= 0 Increment 
= 1 Decrement 

Bit 1 = Reserved 


Bit 0 = Device size 


Transfer Control Byte 2, where: 


Bits 7-1 = Reserved 
Bit 1 = Device size 


continued 
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Function: 10h — DMA Transfer from Memory to I/O, Continued 


Return Codes 


_ This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


FFFFh Return Code Field Not Valid 
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Function: 11h — Read from 1/O and Write to Memory 


Description 


This function is a single-staged request that reads the specified number of 
bytes from the specified I/O port address (0018h or 001Ah) and writes the 
bytes to the specified memory location. 


Request Block Structure 


[oreo] sue [mew doe 


| 02h _ | Word | 
oan | Word 
Tosh | Word 
Ton | word || 
[14n_| DWord 


Ml Ress coun of Data to Transfer (in 
bytes) 


Mode Control, where: 


Bits 7-3 = Reserved 
Bit 2 = Programmable I/O 
Bit 1 = Reserved 

Bit 0 = Auto initialization 


Transfer Control Byte 1, where: 


Bits 7-3 = Reserved 
Bit 2 = Count control 


0 Increment 
1 Decrement 
Bit 1 = Reserved 
Bit 0 = Device size 
8-bit 


1 16-bit 
Transfer Control Byte 2, where: 


Bits 7-1 = Reserved 
Bit 1 = Device size 


Arbitration Level to Use . 


continued 
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Function: 11h — Read from I/O and Write to Memory, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


FFFFh Return Code Field Not Valid 
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Function: 12h — Load DMA Controller Parameters 


Description 


This function is a single-staged request that programs the DMA Controller 
with the specified input values. 


Request Block structure 


[con | word : 
| 02h _ | Word | 
ret Word : 
| 
: 
| OEh | Word |i. a 
3 
[14n_| DWord _ , 


DWord |} Count of Data to Transfer (in : 
bytes) : 


1Ch Byte Mode Control, where: 
Bits 7-3 = Reserved 
Bit 2 = Programmable |/O 
Bit 1 = Reserved 
Bit 0 = Autoinitialization 


Byte Transfer Control Byte 1, where: 
Bits 7-3 = Reserved 
Bit 2 = Count control 
0 Increment 
7 1 Decrement 
Bit 1 = Reserved 
Bit 0 = Device size 
0 8-bit 
1 16-bit 


Byte | Transfer Control Byte 2, where: 
Bits 7-1 = Reserved 
Bit O = Device size 
0 8-bit 
1 16-bit 


[_1Fh | Byte || Arbitration Level to Use | 


continued 
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Function: 12h — Load DMA Controller Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


FFFFh Return Code Field Not Valid 
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21 


Chapter 21 


ABIOS Programmable Option 
Select Service 


Overview 


Description 


The ABIOS Programmable Option Select (POS) Service provides functions 
that access and manipulate the eight POS registers on each adapter card 
and the system board and provide access to the CMOS RAM associated 
with the POS feature. 


Identifying the correct CMOS RAM locations 


The ABIOS Programmable Option Select Service determines if CMOS RAM 
and Extended CMOS RAM are available in the system. It examines the POS 
System ID byte, which identifies the machine type. This test is performed 
for every function call to this service. 


continued 
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Overview, Continued 


Programmable Option Select 


POS is designed to eliminate switches from the system board and adapter 
cards. In place of switches, POS provides eight programmable registers. 
These registers are set by information contained in Adapter Descriptor Files 
supplied by adapter card manufacturers. 


Adapter Description Files 


Adapter Description Files (ADFs) are provided by the adapter card manufac- 
turer for each adapter card. A reference diskette reads a unique adapter ID 
number from each card, matches it with an ADF file, and configures the 
system according to the information provided by the ADF. 


Summary of Programmable Option Select Service functions 


| Funetion | Description 
| 00h Default Interrupt Handler 


Return Logical ID Parameters 
| OBh Read Stored POS Data from CMOS RAM 
Write Stored POS Data from CMOS RAM 


Read POS Data from an Adapter 
Write Dynamic POS Data from Adapter 


In this chapter 


This chapter includes information about the following topics: 
» Hardware Environment 

* Error Handling 

» ABIOS POS Service functions 
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Hardware Environment 


Introduction 


The ABIOS POS Service assumes that the system is based on IBM’s Micro 
Channel! or its equivalent. POS is an integral part of the Micro Channel Archi- 
tecture (MCA). 


Adapter slots 


ABIOS supports systems with up to eight adapter cards (or more with cus- 
tomization). ABIOS will work with any system regardless of the number of 
adapter slots available. 


Adapter card identification 
Each adapter card must have a unique 2-byte identifier. 


Adapter description files 


POS data is accumulated in adapter description files (ADFs) for each 
adapter. A reference diskette reads .ADF files, which are created by adapter 
manufacturers, and stores configuration information in CMOS RAM. The BIOS 
POST routine reads the CMOS RAM and writes the configuration information 
to the POS registers of the adapters and the system board. 


continued 


ABIOS Programmable Option Select Service 571 


Hardware Environment, Continued 


Programmable option select I/O Ports | 
The following table lists the POS I/O port addresses: 


Read/Write | 
1/O Port Status Description 


0094h R/W System Board Setup Enable Register, where: 
Bits 4-0 = Reserved 


es 
R/W 


Channel Position Select Register, where: 


00h =No channel selected 
08h = Channel 1 selected 
09h = Channel 2 selected 
OAh =Channel 3 selected 
OBh = Channel 4 selected 
O0Ch = Channel 5 selected 
ODh = Channel 6 selected 
OEh = Channel 7 selected 
OFh = Channel 8 selected 
80h = Channel reset 


Note: Bits 4,5, and 6 are set to 1 when read 


OEE A a 
POS Register 0 — Adapter Identification Byte 
(Least Significant Byte) 
POS Register 1 — Adapter Identification Byte 
| (Most Significant Byte) 


POS Register 2 — Option Select Data Byte 1 


Bits i 1 = Reserved 
= 1 Card enable 


| RW, POS Register 3 — Option Select Data Byte 3 
| Rw POS Register 4 — Option Select Data Byte 4 


0105h R/W POS Register 5 — Option Select Data Byte 4, 


Bit 7 = 0 Setup system board functions 
1 Enable system board function 
Bit 6 = Reserved 
Bit 5 = 0 Setup VGA 
1 Enable VGA 


where: 
Bit 7 = 1 Channel Check active 
Bit 6 = 0 Channel Check exception status 


available in POS registers 6 and 7 
= 1 No status available 
Bits 5-0 = Reserved 


POS Register 6 — Subaddress extension (LSB) 


POS Register 7 — Subaddress Extension (MSB) 
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Error Handling 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


If Bit 15 of the Return Code field is set, the Programmable Option Select 
Service function requested has an error. The caller’s Return Code handler 
routine should test Bits 14, 13, 12, for the class of error that has occurred 
and then test the remaining bits to determine the nature of the error. 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns information about the 
specified Logical ID. 


nedvest Block Structure 


oe ee | Request Block Length (20h) aS 
| o2h | Word || Logical ID 


04h Word Unit 
Word . : 


= 


— 
| Byte 
Device ID (0010h) 

Word Logical ID Flags 


Bits 15-4 = Reserved 


Bit 3 = 0 No overlap across 
units 
Bit 2 = 0 Reserved 
Bits 1-O = Transfer Data Pointer 
ode 
00 = No Pointers 
Required 


| 
=||_ functions 

1Ah | Reserved initialize to 0000h 
pyte_|f 
x ee 


continued 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Functions: 02h - 0OAh — Reserved 


Function: OBh — Read Stored POS Data from CMOS RAM 


Description 


This function is a single-staged request that places the two POS Adapter 
Identification bytes from CMOS RAM into the Request Block at offset 12h. It 
also moves the contents of the POS Option Select Data Bytes 1-4 from 
CMOS RAM to the address specified by the data buffer pointer at offset 16h 
in the Request Block. 


continued 
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Function: 0Bh — Read Stored POS Data from CMOS RAM, Continued 


Request Block Structure 


| 00h | Word | | Request Block Length si satgratneteetaleteleetetetatstatetatycetatetetscetalateteliterstetatateletatetatalatatatetatelatetscetererstetstetetatals otetetareraletela. estate 
[oan | Word — 

[oan | Word |[unt 
| 06h | Word _| 


Byte Slot Number, where: 
Bits 7-4 = Reserved 
| Bits 3-0 = Slot Number, where: 

0000b = System board 
0001ib = Slot 1 
0010b = Slot 2 
0011b = Slot 3 | 
0100b = Slot 4 
0101b = Slot 5 
0110b = Slot 6 
0111b =Slot7 
1000b = Slot 8 


| 11h | Byte || Reserved (initialize to0000n) |} 
[tah_[ Word || : 
[14m [Word z 
[—~Ten_|_Dwerd 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


0000h 
80FEh 
_80FFh 
_coooh | Invalid Logical DO 
cooth | Invalid Function 
C003h 
co04h 
| _FFFFh 
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Function: 0Ch — Write Stored POS Data from CMOS RAM 


Description 


This function is a single-staged request that copies the Adapter ID data from 
offset 12h in the Request Block to CMOS RAM. It also copies the first four 
bytes of the contents of the data buffer at the address specified in offset 
16h of the Request Block to POS Registers 2-5 (Option Select Data Bytes 
1-4) in CMOS RAM. 


Request Block Structure 


[2h | Word — 
[06h Word 
[oan | Word — 
[oh | Word 


Byte Slot Number, where: Be 
Bits 7-4 = Reserved 
Bits 3-0 = Slot Number, where: 
0000b = System board 
0001b = Slot 1 
0010b = Slot 2 
0011b = Slot 3 
0100b = Slot 4 
0101b = Slot 5 
0110b = Slot 6 
0111b = Slot 7 
1000b = Slot 8 


[12h_| Word 
[14h Word — = 
[teh | DWord 


continued 
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Function: 0Ch — Write Stored POS Data from CMOS RAM, 


Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


=< 


| FFFFh Return Code Fleid Not Valid | | 
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Function: 00h — Read POS Data from an Adapter 


Description 


This function is a single-staged request that reads the POS Adapter Identifi- 
cation bytes directly from |/O ports 0100h and 010th and enters this data in 
the Request Block at offset 12h. It also copies the POS Registers 2-5 (Op- 
tion Select Data Bytes 1-4) from I/O ports 0102h-0105h to the data buffer 
pointed to by the address in offset 16h of the Request Block. 


Request Block Structure 


Ooh} word || Recweet Block Length ___f 
Word |[unt Cd 
tee oa ee 
[oan | word || Reserved (Initialize to 0000h) || 
[och | "word || Return Code di Return Code 


Byte || Slot Number, where: : 
Bits 7-4 = Reserved 

Bits 3-0 = Slot Number, where: 

0000b = System board ||: 

0001b = Slot 1 : 

0010b = Slot 2 

0011b = Slot 3 3 

0100b = Slot 4 : 

0101b = Slot 5 3 

0110b = Slot 6 : 

0111b = Slot 7 : 

1000b = Slot 8 ; 


11h | Byte || Reserved (initialize to 0000h) | 

| 12h | Word _| Adapter Card ID _ 

| 14h | Word || Reserved (initialize to 0000h) 

-it_| Dera Pointer to Data Buffer Option Select Data Bytes 1-4 : 


Reserved (initialize to 0000h) aS 


continued 
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Function: 0Dh — Read POS Data from an Adapter, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Function: 0Eh — Write Dynamic POS Data from an Adapter 


Description 


This function is a single-staged request that writes the first four bytes of 
data found at the address specified in the Request Block at offset 16h to 
I/O ports 0102h-0105h (POS Registers 2-5 containing Option Select Data 
Bytes 1-4). 


Request Block Structure 


fortser| size |] inputs ff outputs 
| ooh | Word _| : 
[02h | Word — 
| 04h | Word |} Unit | 
[06h | Word 
| 08h | Word || Reserved (initialize to 0000h) _—i 
. 
ae 


Byte Slot Number, where: 
Bits 7-4 = Reserved 
Bits 3-0 = Slot Number, where: 
0000b = System board 
| 0001b = Slot 1 
0010b = Slot 2 
0011b = Slot 3 
0100b = Slot 4 
0101b = Slot § 
: 0110b = Slot 6 | 
| 0111b = Slot 7 
1000b = Slot 8 


[toh [ Word 


Reserved (initialize to 0000h) 


continued 
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Function: 0Eh — Write Dynamic POS Data from an Adapter, 
Continued | | 


Return Code 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Chapter 22 
ABIOS Keyboard Security Service 


Overview 


Introduction 


The ABIOS Keyboard Security Service consists of a set of functions that 
allow the caller to implement the security features of PS/2—compatible 
systems. Security features include password-controlled access to the 
system. 


Types of password 


Micro Channel-based PS/2-compatible systems may support two types of 
passwords: a power-on password, and a keyboard security password. 
Password security is controlled through a reference diskette utility. 


Power-on password 


The power-on password limits access to a PS/2-compatible system by 
testing for a password when the system is first turned on. Passwords are 
controlled by the end user through the reference diskette. The power-on 
password is stored in nonvolatile CMOS RAM. 


continued 
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Overview, Continued 


Keyboard security password 


The keyboard security password limits access to a PS/2-compatible system 
by testing for a password when the first attempt to use the keyboard is 
made. Passwords are controlled by the end user through a reference disk- 
ette. The keyboard security password is stored in 8042 RAM. 


Password storage 


The Keyboard Security password is stored in 8042 RAM and is thus volatile. 
Initially, the BIOS uses the power-on password as the keyboard security 
password. The power-on password is stored in nonvolatile CMOS RAM (at 
38h) and is transferred to the 8042 during the BIOS POST initialization. 


How passwords are set 


The Reference Diskette controls the passwords for both the power-on pass- | 
word and the keyboard security password. See the manual which accompa- 
nies your reference diskette for more information about system password 
protection. | 


Summary of ABIOS Keyboard Security Service functions 


584 


Description 


femosh [Reserved 
[teh | “Enable Keyboard Security 
Reserved | 

[tan [Write Password 
[aon [wie Match oye 


Write Filter Byte 1 
Write Filter Byte 2 


continued 
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Overview, Continued 


in this chapter 


This chapter includes information about the following topics: 
» Hardware Environment 

» System Scan Codes 

» Error Handling 

ABIOS Keyboard Security Service functions 


Hardware Environment 


Introduction 


The ABIOS Keyboard Security Service interfaces with the features of an 


appropriately programmed Intel 8042 (or equivalent) intelligent keyboard 
controller. 


Storage of Keyboard Security data in 8042 


The following table shows where the Keyboard Security function bytes are 
stored in the 8042 and the values to which they are initialized. 


8042 RAM 
Location Keyboard Security Function Initialized Value 


[sn | tmccaton aye 
SE 
en | tor ate ta Sa Key 


Filter Byte 2 Right Shift Key 
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System Scan Codes 


The following system scan codes, including multiple byte codes, can be 
used for the Write Password, Write Invocation and Write Match Byte 
functions. 


Typewriter/Function Keys 


rece System Sean 
Key # Legend Codes (hex) 


cut System Scan 
Key # Legend Codes (hex) 


a ee 
2 
ae OO 
a a 


io) 
N 
Hee 


N 
rm 
” 
=. 
= 5 


101-key only 


— Lock 


b 


| 4 


pe) 


102-key only 


O 


102-key only 


wo 
©) 


—_ 
N 


continued 
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System Scan Codes, Continued 


Typewriter/Function Keys, cont’d 


bevee a System Scan 
Key # Legend Codes (hex) 


aad veces System Scan 
Key # Legend Codes (hex) 
[ies [eee [ 
ies” [S Pape oown| 7A 
ae 
_ 7B 
7 
7 
5 
ae 
oe 


Tape 
oS ES 
Tes fr 
Csr | Asn 


Le 
| 60 
Pet 
4 | 
[90 | Num Lock 
| st | 7 Home 
92 | 4teft 
za 
| 96 
| 97 
ae] 
= 
[100 


Scroll Lock 


Other keys 


The rest of the keys send a series of codes that depend on the state of the 

shift keys (Ctrl, Alt, and Shift) and the Num Lock key (On or Off). Since the 
base scan code is the same as that for another key, an additional code (hex 
EQ) is added to the base code so that it is unique. The following four tables 

summarize the scan codes for these other keys. 


continued 
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System Scan Codes, Continued 


Cursor/Control Keys 


Base Case or. 
ee a Shift + 
— # Legend Num Lock Shift Case* Num Lock on 

Insert EO-70 EO FO EO 12 
12 EO 70 EO 70 
Delete E0-71 EO FO EO 12 
12 EO 71 EO 71 
Left E0-6B EO FO EO 12 
12 EO 6B EO 6B 
| Home E0-6C EO FO EO 12 
12 EO 6C EO 6C 
EO FO EO 12 
12 EO 69 EO 69 

E0-75 EO FO EO 12 

12 EO 75 EO 75 


E0-72 EO FO EO 12 
12 EO 72 EO 72 


Page Down E0-7A EO FO EO 12 
| 12 EO 7A EO 7A 

E0-74 | EO FO | EO 12 

12 EO 74 EO 74 


* With the Left Shift key down, the FO 12 shift code is added to the other scan 
codes sent. With the Right Shift key down, FO 59 is added. When both keys are 
down, both sets of codes are sent with the rest of the scan code. 


a hd wey on Numeric Keypad 


U.S. Keyboard System Sean Codes 
Key # Legend (hex) Shift Case* 
EO 4A EO FO 
12 EO 4A 


* With the Left Shift key down, the FO 12 shift code is added to the other scan 
codes sent. With the Right Shift key down, FO 59 is added. When both keys are 
down, both sets of codes are sent with the rest of the scan code. 


continued 
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System Scan Codes, Continued 


Print Screen/Sys Req Key 


Gas System Scan Ctri Case 
Key # Legend Codes (hex) Shift Case Alt Case 
Print Screen EO 12 EO 7C 
EO 7C 


Pause/Break Key 


U.S. Keyboard System Scan Codes 
Key # Legend (hex) Ctri Key Pressed 
Pause E114 77 EO 7E E0 
E1 FO 14 FO 7E 
FO 77 


Error Handling 


How errors are reported 
ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) 


of 


each ABIOS request by returning a one word Return Code at offset OCh in 


the Request Block. 


If Bit 15 of the Return Code field is set, the Keyboard Security Service func- 
tion requested has an error. The caller’s Return Code handler routine should 
test Bits 14, 13, 12, and 8 for the class of error that has occurred and then 


test the remaining bits to determine the precise nature of the error. 


ABIOS Keyboard Security Service 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns the parameters for the 
Logical ID associated with the keyboard hardware. 


Request Block Structure 


Request Block Length (20h) : 
: 
| 


|| Device ID (0016h) 
|| Count of Units. 


Logical ID flags | 


Bits 15-4 = Reserved 
Bit 3 = 0 No overlap across 
units 
= 1 Overlap across units 
supported 
Bit 2 = 0 Reserved 
Bits 1-O = Transfer Data Pointer 
Mode 
00 No Pointers 
Required 


eo S221 Revision Level 


, Request Block Length (for other 
1) functions) 
|| Reserved (initialize to 0000h) : 


|| Secondary Device ID 
Reserved (initialize to 0000h) : 


continued 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Code 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[eve [ onrononon 
[000s [Not My iterunt, Resume Stage after Interupt 


Function: 02h — Reserved 
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Function: 03h — Read Device Parameters 


Description 


This single-staged function returns the maximum password length 
(1-7 bytes). 


Request Block Structure 


| ooh | Word — Request Block | Request Block Length ssid 

| 02h | Word |} Logical ID 

| 04h | Word || Unit | 
|06h_| Word _| 
| 08h | Word 


ate He Maximum Password Length 


| 1th | Byte _ Reserved (initialize to 0000h) ae HEE nr Onin me tierce eres : 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


3 
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Functions: 04h -— 05h — Reserved 


Function: 06h — Enable Keyboard Security 


Description 


This single-staged function enables keyboard security. It is called after the 
Write Password, Write Invocation Byte, Write Match Byte, and Write Filter 
Byte functions have initialized the password entry procedure. 


Request Block structure 


| 00h | Word | : 
[02h | Word 

To 
| | Word _ : 
: 
| tih_| 1 Byte _ : 


continued 
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Function: 06h — Enable Keyboard Security, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


C00th Invalid Function Number 


C005h Invalid Keyboard Security Parameter 
FFFFh | Return Code Field Not Valid 


Functions: 07h - 0Ah — Reserved 
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Function: 0Bh — Write Password 


Description 


This single-staged function sets the password or changes an existing pass- 
word. Write Password writes a string of system scan codes from 1-7 bytes 
long to 8042 RAM (see the System Scan Code tables in this chapter). 


A password example 

The password, ABC, is stored in the 8042 as follows: 
1Eh 30h 2Eh 1Ch OOh 

where 
=» 1Eh is the system scan code for A 
# 30h is the system scan code for B 
=» 2Eh is the system scan code for C 
» 1Ch is the system scan code for the Return key 
= The 00h is set by the ABIOS 


The routine using this function matches each character as it is received from 
the keyboard. When the return key scan code is received, it is matched, 
which signals the end of the password. 


Password storage 


The Keyboard Security password is stored in 8042 RAM and is thus volatile. 
Initially, the BIOS uses the power-on password as the keyboard security 
password The power-on password is stored in nonvolatile CMOS RAM (at 
38h) and is transferred to the 8042 during the BIOS POST initialization. 


continued 
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Function: OBh — Write Password, Continued 


Request Block Structure 


a 


[2h] Word 
[06h | Word 
| 08h | Word | 


- 
Third Scan Code 
| Byte 


Byte 
[—1an| Byte || Seventh Scan coded 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


C005h invalid Keyboard Security Parameter 
This value is set and no action is taken if the Password 
Length field is 0 or greater than 7 bytes 


FFFFh . Return Code Field Not Valid 
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Function: 0Ch — Write Invocation Byte 


Description 


This single—staged function sets or changes the Invocation Byte. The Invoca- 
tion Byte may contain any system scan code. The byte is stored at location 
33h in 8042 RAM. The default value for this scan code is zero. 


Invocation Byte usage 


This byte acts as a signal from the 8042 to the caller indicating that a valid 
password has been loaded and that password security has been enabled. 
The Invocation Byte is returned to the caller to invoke security. If the Invoca- 
tion Byte is zero, keyboard security is not enabled. 


Request Block Structure 


[oveer] sae [meee owe 


[con | werd 
| 06h | Word | 
oan | Word 
Return Code || Return Code 
oth | Wea | 

ton Byte 
ih | Byte |  . 


continued 
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Function: 0Ch — Write Invocation Byte, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Code 


Co005h Invalid Keyboard Security Parameter 
FFFFh Return Code Field Not Valid 
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Function: 0Dh — Write Match Byte 


Description 


This function sets or changes the Match Byte. The byte is stored in location 
34h of 8042 RAM. The default value is zero. 


Match Byte usage 


This byte is used as a signal from the 8042 to the caller that keyboard 
security has been disabled now that the keyboard input matches the system 
scan code(s) in the password field. The 8042 sends this byte to the caller 
using a keyboard interrupt. If the Match Byte is zero, it will not be used to 
signal the keyboard security disabled status to the caller. 


Request Block Structure 


[over] sue [redo 


[con | wera _ 
| 02h _ | Word | 
oan | wore] 
08h | Word — 
[och | Were 
[on _|_Wore | z 
[11h [Byte |[ Reserved (initialize to 000m) I] — 


continued 
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Function: 0Dh — Write Match Byte, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Cooth Invalid Function Number 
C003h Invalid Unit Number 


C004h Invalid Request Block Length 
C005h Invalid Keyboard Security Parameter | 
FFFFh Return Code Field Not Valid 
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Function: 0Eh — Write Filter Byte 1 


Description 
This function sets or changes Filter Byte 1. This byte contains a system scan 
code that is ignored if it is encountered during password validation. Filter 
Byte 1 is initialized to left shift key. 


Usage of Filter Bytes 


lf unaltered, Filter Bytes 1 and 2 together ensure that keyboard security input 
is not case-sensitive. 


Request Block Structure 


[over] sue mew foe 
| 02h | Word | 

| 04h | Word _ 
| 06h _ | Word _| 
| 08h_| Word | 
: 


[ton [Byte : 


| 1th | Byte || Reserved (initialize to 0000h) : 


continued 
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Function: 0Eh — Write Filter Byte 1, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 
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Function: 0Fh — Write Filter Byte 2 


Description 


This function sets or changes Filter Byte 2. This byte contains a system scan 
code that is ignored if it is encountered during password validation. Filter 
Byte 2 is initialized to right shift key. 


Usage of Filter Bytes 


If unaltered, Filter Bytes 1 and 2 together ensure that keyboard security input 
is not case-sensitive. 


Request Block Structure 


| oon | Word _ : 
Word 
| 06h _[ Word _ 
: 
: 


Filter Byte 2 
Reserved (initialize to 0000h) 


continued 
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Function: 0Fh — Write Filter Byte 2, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


[|_code | Description 
| e000n__ | Device Busy 
sc 


Co00th | Invalid Function Number | 
~ ©003h Invalid Unit Number 3 | 


C004h Invalid Request Block Length 
C005h Invalid Keyboard Security Parameter 


FFFFh Return Code Field Not Valid 
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Chapter 23 
ABIOS Error Log Service 


Overview 


Introduction 


The ABIOS Error Log Service is used by the operating system to read and 
write error messages to the system error log area in extended CMOS RAM. 


This service can only be used by systems that have extended CMOS RAM. 


ABIOS start routines 


Requests for the ABIOS Error Log Service should use only the ABIOS start 
routine. There is no need to use the interrupt or time-out routines. 


continued 


ABIOS Error Log Service 605 


Overview, Continued 


| sumnmnaty of Error =e Service functions 


Return Logical ID Parameters 


om] 

reese ee 
[06m [Reed Erortog 
[00m witetoerortoa 
OO 


In this chapter 
In this chapter, the following topics are discussed: 
» Hardware environment 
e Error handling 
® ABIOS Error Log Service functions 
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Extended CMOS RAM 


Introduction 


The ABIOS Error Log Service assumes that at least 2K of Extended CMOS 
RAM is available in the system. 


CMOS RAM Error Log Area 


Up to six 20-byte error log blocks can be stored in Extended CMOS RAM 


Note: If all error log block positions contain error information, as a new 
error log block is read in, the oldest error log block is overwritten. 


Extended CMOS RAM Error Block data area 


[eon | ERAWUW — Number of Eror Log anvea — can be G6 
—s9en | Eortoe Book? 
<1 
[seen | Erortog ks SSS 


Using ERRNUM 


ERRNUM is a pointer to the next available error log peek It is maintained by 
the operating system. 


Pending error log blocks 


The operating system must keep track of the total number of active error log 
blocks pending. 


If more than six error log blocks are written to extended CMOS RAM, syn- 
chronization errors may occur unless the error log blocks are tracked by the 
operating system. 


continued 


ABIOS Error Log Service 607 


Extended CMOS RAM, Continued 


Error Log Block format 


| om | steve | Error iD Byte 
| 1 Byte | Interrupt Level 7 


| Arbitration Level | 


| 

ph 
Pah 
[oer [ate | erent seconde @00) 
ion ate | rrent Hours (@6D) 
[in| Fete carent Month (805) 
p 18h | 4 Byte Current Year (BCD) 


i/O ports 


The ABIOS Error Log Service accesses the following I/O port addresses to 
access CMOS RAM locations. 


| Read/Write | 
I/O Address Status Description 


0074h WwW Extended CMOS RAM address register port, 
: least significant byte | 
0075h WwW Extended CMOS RAM address register port, 
most significant byte 
Extended CMOS RAM data register port 


0076h 
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Error Handling 


How errors are reported 


ABIOS signals the status (Successful, Resume Stage after Interrupt, etc.) of 
each ABIOS request by returning a one word Return Code at offset OCh in 
the Request Block. 


lf Bit 15 of the Return Code field is set, the Error Log Service function re- 
quested has an error. The caller’s Return Code handler routine should test 
Bits 14, 13, 12, and 8 to determine the class of error that has occurred and 
then test the remaining bits to determine the precise nature of the error. 
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Function: 01h — Return Logical ID Parameters 


Description 


This function is a single-staged request that returns information about the 
specified Logical ID. 


Request Block structure 


CS 


| Request Block Length (20h) || : : 
runt SCS~S~S 
[_06h_| Word || "Function (o001mR) 
[08h | Word — 
| Ah | Word || Reserved (initialize to 0000h) |] oe 
[och | Word 


| offset 
ae 


Hardware Interrupt Level (FFh) | 
Arbitration Level (FFh) 


| Device ID (0001 1h) 
Count of Units (000th) 


Logical ID Flags (0000h) 
| Bits 15-4 = Reserved - 


Bit 3 = 0 No overlap across 
units 
Bit 2 = 0 Reserved 
Bits 1-0 = Transfer Data Pointer 
| Mode 
00 = No Pointers 
Required 


: ee : functions) | 
7 | Reserved (initialize to 0000h) _| 
Lc c 


continued 
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Function: 01h — Return Logical ID Parameters, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


FFFFh | Return Code Field Not Valid 


Functions: 02h - 07h — Reserved 
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Function: 08h — Read Error Log 


SRE cS RTI I ESE EP TN LE RTE TI TE SE EE 


Description 
This function, a single-staged request, returns the most current error log 
block from extended CMOS RAM. After the error log entry is read, the 
memory location it was stored in is cleared to zero. Up to six active error 
log entries can exist at one time. 


Device-specific parameters 


The operating system must determine the contents and format of the 10 

bytes of device-specific parameters that are input at offset 14h of the Re- 

quest Block in Function 09h, Write Error Log. Each device type should have 
a different set of device-specific parameters. 


Request Block Structure 


jottser| size || inputs | Output 
— Request Bleck Length __ Block Length & 3 


| 02h | Word Log Re rca iD 


| 04h | Word et 

| 06h | Word | Function (00088) ——_—_—_—_ 0008h 

| 08h | Word _| Reserved _(ntiatze te-0000h| initialize to 0000h 
Reserved | Reserved (initialize to 0000h) i to 0000h) = z 


Current Month (in BCD) 
=1| Current Year (in BCD) 


ND HE 
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Function: 08h — Read Error Log, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Description | 


0000h Successful Operation | | 
|  80FEh CMOS RAM Checksum Invalid 


[conan vate Request Block Lenath SCS 


C005h Invalid CMOS RAM Parameter 


This field is set and no action is taken if the bytes in the 
Number of Bytes to Transfer field plus the byte count for 
the Starting RAM Address field in the Request Block is 


greater than the maximum amount of RAM. 
FFFFh 


| Return Code Field Not Valid 
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Function: 09h — Write to Error Log 


Description 


This function, a single-staged request, writes a 20-byte error log block to 
the next available error log entry in the external CMOS RAM error log block 
data area. 


Device-specific parameters 


The operating system must determine the format and contents of the ten 
bytes of device-specific parameters that are input at offset 14h of the Re- 
quest Block. Each device type should have a different set of device—specific 
parameters. | 


Request Block Structure | 


| 00h | Word 
[02h | Word 
[06h | Word 
|_OCh | Word _ 


[1h [ayte 
[13 [Byte 
[14n~ [10 Bytes|| Device-specifio Parameters 
| _1Eh_| Byte 


~ Current Seconds (in BCD) a 
Current Minutes (in BCD 


Reserved | 
Reserved 


Current Year (in BCD) 


continued 
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Function: 09h — Write to Error Log, Continued 


Return Codes 


This list contains only the most common Return Codes for this function. Test 
all valid bits in the Return Code field to ensure proper performance. 


Code 


| Invalid CMOS RAM Parameter 


Co005h 
This field is set and no action Is taken if the bytes in the 
Number of Bytes to Transfer field plus the byte count for 
the Starting RAM Address field in the Request Block is 
greater than the maximum amount of RAM. 


| FFFFh | Return Code Field Not Valid | 
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Appendix A 
ABIOS Return Codes 


Overview 


Description 


The following tables list common ABIOS Return Codes, the description of 
the Return Code, the ABIOS Service that generated the code, and a sum- 
mary of the Return Code field bit setting meaning. See Chapter 6 for more 
detailed information about Return Codes. 


Return Code bit settings 


Any program or routine that uses the ABIOS should check the bit settings © 
for bits 15, 14, 13,12, 7, 6, 5, 4, 3, 2, 1, and O in every Return Code. 
ABIOS is open and can be modified in many ways. Any code that is an 
extension of the ABIOS is able to set a combination of Return Code bit 
settings that would have a new and different meaning than those listed in 
the following tables. 


It is also possible for bits 7-O to take on different meanings depending on 
the settings of Bits 15, 13, 12, and 8. These meanings will be device— 
specific error indications that are listed in the service chapters (Chapters 
8-23). | 
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Return Codes that Indicate Action is Required 


The following Return Codes indicate that a new stage in a multistaged | 
request has occurred. The caller must handle the conditions indicated by 
these messages in order to continue processing. It is possible for other 
combinations of Bits 0, 1, 2, and 7 to occur. The caller’s Return Code 
handling routine should test each meaningful bit of the Return Code field 
each time a Return Code is processed. 


Return | 
Code | Description Action Required 


Incomplete — resume A stage in a multistaged request has been 
| stage after interrupt | completed; at the next interrupt on this 
| ae the caller should resubmit this Request 
ock. 


Resume stage after A stage in a multistaged request has been 
time delay reached; after the appropriate time delay, the 
caller should resubmit this Request Block. 


Incomplete — not my A stage in a multistaged request has been 

interrupt, resume completed; the operation is not complete, the 

stage after interrupt interrupt that just occurred is not for this 
device, at the next interrupt on this device, 
the caller should resubmit this Request Block. 


Attention, resume A stage in a multistaged request has been 

stage after interrupt completed; the device needs attention, at the 
next interrupt on this device, the caller should 
resubmit this Request Block. 


0081h ernenten Interrupt The interrupt for this device has been reset, 
reset restart the Request Block. 
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Return Codes that Indicate Termination 


Non-error Return Codes 


There are two conditions that may occur in a Return Code field that do not 
indicate an error: 


» Q000h — Successful Operation. The request has been completed. 


= FFFFh — Return Code Field Not Valid. The request has not been 
processed by ABIOS yet. 


Return Code table 


The following Return Codes indicate that the request has been terminated, 
either successfully or unsuccessfully. All Return Codes listed below (except 
OO00Oh and FFFFh) indicate an error. If Bit 15 is on, the Return Code is 
Return 


always an error. 
Originating 
ABIOS 
Code Description Service Meaning 
0000h | Successful Operation Successful operation | 
8000h | Device Busy, Request Any Unsuccessful operation. see 
Refuse | additional return codes. 
8001h | Device Busy Parallel Unsuccessful operation | 


d 
8001h | Arbitration Level Not DMA Unsuccessful operation 
Available 
8001h | Real Time Clock Not RTC Unsuccessful operation 
Started 
RT 
D 


8002h | Interrupt Already Enabled 


8002h | Arbitration Level Not MA Unsuccessful operation 
Allocated 
8002h Mahe hasta Resends | a Unsuccessful operation 
oun 


8003h | System Lock Unsuccessful operation 
8003h | Arbitration Level Disabled Unsuccessful operation 
8003h | Write-Protected Diskette Unsuccessful operation 


8003h | Security Enabled, Key- Keyboard Unsuccessful operation 
Board Inhibited — 
Request Refused 

8003h | Keyboard Locked, Keyboard Unsuccessful operation 
Request Refused Security 
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Return Codes that Indicate Termination, Continued 


Return Code table, cont’d 


| | | Originating 
Return | ABIOS 
Code | Description Service 


| Meaning 


| 8004h | Keyboard Locked, 1 Keyboard j| Unsuccessful operation 
Request Refused 


8004h | Transfer In Process } DMA Unsuccessful operation 
8005h | No Transfer In Process | DMA | Unsuccessful operation 
8006h | Media Changed | Diskette | Unsuccessful operation 


8006h | No Channel Available Unsuccessful operation 


8007h | Arbitration Level Not ) DMA | Unsuccessful operation 
Disabled 


| 800Dh | Media Not Present | Diskette Unsuccessful operation 


800Eh | Change Signal Not Diskette Unsuccessful operation 
| | Available | 


| 800Fh | Invalid CMOS Value | CMOS RAM , Unsuccessful operation 


800Fh | DMA Arbitration Level Fixed Disk Unsuccessful operation 
Out Of Range : 
80FEh | Invalid CMOS Checksum CMOS RAM | Unsuccessful operation, 
| device error | 
80FFh | Bad CMOS Battery CMOS RAM | Unsuccessful operation, 
| = | | device error 
9000h | Bad Com Port Serial | Unsuccessful operation 
| | | | | device error 
9000h | Keyboard Controller Keyboard Unsuccessful operation 
Always Busy | device error 
9000h | Printer Error Serial Unsuccessful operation 
device error . 
9000h | Printer Error Parallel Unsuccessful operation 
) device error 
9001h | Bad Command Parallel Unsuccessful operation 
| 7 device error 
9001h | Keyboard Fallied Reset Keyboard | Unsuccessful operation 
| | device error 
| 9002h | Address Mark Not Found | Parallel Unsuccessful operation 
| device error 
9002h | Resend Error - Parallel | Unsuccessful operation 
device error 


9003h | Keyboard Parity Error Keyboard - Unsuccessful operation 
| = ites Me cote atest dibs device error 
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Return Codes that Indicate Termination, Continued 


Return Code table, cont’d 


Originating 
Return ABIOS | 
Code Description Service Meaning 


9004h | Record Not Found Keyboard Unsuccessful operation 
device error 

9004n | General Hardware Keyboard Unsuccessful operation 
Time-out device error 

Reset Failed | Fixed Disk Unsuccessful operation 
device error 

9006h | Undefined Mode From Keyboard Unsuccessful operation 
Keyboard device error 

9007h | Controller Parameter Fixed Disk Unsuccessful operation 
Activity Failed device error 

9009h | Controller Failure During Keyboard Unsuccessful operation 
Reset device error 

900Ah | Defective Sector Fixed Disk Unsuccessful operation 
device error 

900Bh | Bad Track Fixed Disk Unsuccessful operation 
device error 

900Dh | Invalid Sector On Format Fixed Disk Unsuccessful operation 
device error 

CAM Detected During Fixed Disk Unsuccessful operation 
Read Or Verify device error 

Uncorrectable ECC Or Fixed Disk Unsuccessful operation 
CRC Error device error 

Bad Controller Fixed Disk Unsuccessful operation 
Diskette device error 

Equipment Check | Fixed Disk Unsuccessful operation 

device error | 

9040h | Bad Seek Fixed Disk Unsuccessful operation 
device error 

9080h | Device Did Not Respond Fixed Disk, Unsuccessful operation 
Diskette device error 

90AAh | Drive Not Ready Fixed Disk Unsuccessful operation 
device error 

9OBBh | Undefined Error Fixed Disk Unsuccessful operation | 

| device error 

OCCh | Write Fault Fixed Disk Unsuccessful operation 
| device error 
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Return Codes that Indicate Termination, Continued 


Return Code table, cont'd 
Originating 
Return ABIOS 
Code | Description Service Meaning 


90CCh | Keyboard Controller Keyboard Unsuccessful operation device 
| Always Busy error 
| S90FFh | Incomplete Sense Fixed Disk | Unsuccessful operation device 
Operation | | error 
9100h | Controller Failure | Unsuccessful operation device | 
| | error | 


| 9100h | Keyboard Controller | Keyboard Unsuccessful operation device 
Always Busy error 

| Keyboard Failed Reset | Keyboard j| Unsuccessful operation device 
error 


Bad Command : Parallel | Unsuccessful operation device 
| error 
Address Mark Not Found Diskette Unsuccessful operation device 
error 
Resend Error | Keyboard Unsuccessful operation 
retryable device error 


Resend Error Parallel Unsuccessful operation device 
| error 


Keyboard Parity Error | Keyboard Unsuccessful operation device 
| error 
| Parity Error Fixed Disk Unsuccessful operation device | 
| | | error | 
| 9104h | General Device Time-out | Keyboard Unsuccessful operation device 
| | time-out error | 


9104h | Requested Sector Not Diskette Unsuccessful operation 
Found | retryable device error 


| 9105h Reset Failed . | Fixed Disk Unsuccessful operation 
| retryable device error | 
9107h | Controller Parameter Fixed Disk | Unsuccessful operation 
| Activity Failed | retryable device error | 
9108h | DMA Overrun On DMA, Fixed Unsuccessful operation | 
Operation Disk Diskette | retryable device error | 
9110h | Bad CRC On Diskette Diskette | Unsuccessful operation ! 
| Read | retryable device error 
9120h | Controller Failure Diskette, Unsuccessful operation 
Fixed Disk retryable device error 


continued 


622 ABIOS for IBM PS/2 Computers and Compatibles 


Return Codes that Indicate Termination, Continued 


Return Code bit table, cont’d 


Originating | 
Return ABIOS 
Code Description Service Meaning 


Equipment Check Fixed Disk, Unsuccessful operation 
Diskette retryable device error 
Seek Operation Failed Diskette, Unsuccessful operation 
Fixed Disk retryable device error 
9180h | Device Did Not Respond Diskette, Unsuccessful operation 
Fixed Disk retryable device error 
91AAh | Drive Not Ready Fixed Disk Unsuccessful operation 
retryable device error 
91BBh | Undefined Error Fixed Disk Unsuccessful operation 
retryable device error 
91CCh | Write Fault Fixed Disk Unsuccessful operation 
retryable device error 
91FFh | Incomplete Sense Fixed Disk Unsuccessful operation 
Operation retryable device error 
A0O00h | Time-out Fixed Disk Unsuccessful operation 
retryable device error 
A00Oth | Bad Command Fixed Disk Unsuccessful operation 
retryable device error 
A002h | Address Mark Not Found Fixed Disk Unsuccessful operation 
retryable device error 
A004h | Record Not Found Fixed Disk Unsuccessful operation 
time-out error 
AO005h | Reset Falled Fixed Disk Unsuccessful operation 
time-out error 
AO007h | Parameter Activity Failed Fixed Disk Unsuccessful operation 
time-out error 
AOOAh | Defective Sector Fixed Disk Unsuccessful operation 
| time-out error 
AOOBh | Bad Track Fixed Disk Unsuccessful operation 
time-out error 
AO0Dh | Invalid Sector On Format Fixed Disk Unsuccessful operation 
time-out error | 
AOOEh | CAM Detected During Fixed Disk Unsuccessful operation 
Read Or Verify time-out error 
A010h | Uncorrectable ECC Or Fixed Disk Unsuccessful operation 
CRC Error time-out error 
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Return Codes that indicate Termination, Continued 
Return Code table, cont’d 


i | _ | | Originating | : 
Return ABIOS 
| Code | Description | Service Meaning 
| AOlih | ECC-corrected Data | Fixed Disk Unsuccessful operation 
| Error time-out error 
A020h | Bad Controller Fixed Disk Unsuccessful operation 
time-out error 
A021th | Equipment Check Fixed Disk Unsuccessful operation : 
= time-out error | 
| A040h | Bad Seek Fixed Disk Unsuccessful operation 
time-out error 
A080h | Device Did Not Respond Fixed Disk Unsuccessful operation | 
: time-out error 
| AOAAh | Drive Not Ready Fixed Disk Unsuccessful operation 
time-out error 
AOBBh | Undefined Error Fixed Disk | Unsuccessful operation 
| | time-out error | 
AOCCh | Write Fault | Fixed Disk Unsuccessful operation 
time-out error 
AOFFh | Incomplete Sense Fixed Disk Unsuccessful operation 
Operation | | time-out error 
A100h | Time-out Occurred — No| Fixed Disk Unsuccessful operation 
| Other Error | | time-out error 
A105h | Reset Falled Fixed Disk Unsuccessful operation 
| | | | device time-out error 
| A107h | Controller Parameter Fixed Disk Unsuccessful operation 
Activity Failed device time-out error 
| A120h | Controller Failure | Diskette, Unsuccessful operation 
| | Fixed Disk | retryable time-out error 
A12th | Equipment Check Fixed Disk Unsuccessful operation 
| | retryable time-out error 
Ai40h | Bad Seek Fixed Disk Unsuccessful operation | 
| | retryabie time-out error 
A180h | Device Did Not Respond Fixed Disk Unsuccessful operation | 
| _ | retryable time-out error 
A1AAh | Drive Not Ready Fixed Disk Unsuccessful operation | 
retryable time-out error 
A1BBh | Undefined Error Fixed Disk | Unsuccessful operation 
| retryable time-out error 
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Return Codes that Indicate Termination, Continued 


Return Code table, cont'd 


Originating 
Return ABIOS 
Code | Description Service Meaning 


A1CCh | Write Fault Fixed Disk Unsuccessful operation 
retryable time-out error 
A1FFh | Incomplete Sense Fixed Disk Unsuccessful operation 
Operation retryable time-out error 
BOO1h | Bad Command Fixed Disk Unsuccessful operation 
: retryable time-out error 
Booth Keyboard Error Keyboard Unsuccessful operation 
retryable device time-out 
error 
BO20h Controller Failure Diskette Unsuccessful operation 
retryable time-out error 
BO20h |} Bad Controller Fixed Disk Unsuccessful operation 
retryable device time-out 
error 
Equipment Check Fixed Disk Unsuccessful operation 
retryable device time-out 
error 
BO80h | Device Did Not Respond Fixed Disk Unsuccessful operation 
retryable device time-out 
error 
Bad Command Fixed Disk Unsuccessful operation device 
time-out error 
Keyboard Error Keyboard Unsuccessful operation 
device time-out error 
Controller Failure Diskette Unsuccessful operation 
device time-out error 
Bad Controller Fixed Disk Unsuccessful operation 
retryable device time-out 
error 
Equipment Check Fixed Disk Unsuccessful operation 
retryable device time-out 
error 
Device Did Not Respond Fixed Disk Unsuccessful operation 
| retryable device time-out 
error 
BOBBh | Undefined Error Fixed Disk Unsuccessful operation 
retryable device time-out 
error 
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Return Codes that Indicate Termination, Continued 


Return Code table, cont'd 


| | | Originating 
Return ABIOS 
Code | Description Service 
BOFFh | Sense Falled | 


Meaning 


Unsuccessful operation 
retryable device time-out 
error 


Fixed Disk 
Unsuccessful operation 


retryable device time-out 


| B1BBh | Undefined Error | Fixed Disk | 

| error 

| BiFFh | Sense Falled | Fixed Disk Unsuccessful operation 

| retryable device time-out 
| | error 


C000h | Invalid Logical ID | An Unsuccessful operation 
| parameter error | 
Cooth | Invalid Function An Unsuccessful operation 
| parameter error 


C003h | Invalid Unit Number | Unsuccessful operation 
parameter error 


y 
y 
Any 
C004h ‘Invalid Request Block | Any | Unsuccessful operation 
Length | Parameter error 
Any 
Any 


| CO005h | Invalid Parameter Unsuccessful operation | 
| parameter error 
Co006h | Invalid Time To Wait | Parallel | Unsuccessful operation 
| | parameter error 
| COOCh | Unsupported Media | Diskette Unsuccessful operation 
Type/Unestablished Media | parameter error 
| FFFFh Return Code Not Valid } Any Request block not processed | 
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Glossary 


ABIOS 
Advanced BIOS. The BIOS designed to support multitasking operating sys- 
tems such as OS/2. It comes packaged with a traditional Compatibility BIOS 
(CBIOS). 

ABIOS Service 
Each ABIOS service controls a hardware device. Each ABIOS Service can 
only be associated with one Device ID. 

Adapter Card 


A circuit board that can be installed into one of the expansion slots inside 
a PS/2-compatible computer in order to expand the capabilities of the 
computer. 


Adapter Description Files (ADFs) 


Text files supplied on a diskette by manufacturers of PS/2—compatible 
adapter cards. The ADFs contain information such as what resources are 
needed to use the card. The ADFs must be copied to a working copy of the 
Reference Diskette after the adapter card is installed. 
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Glossary, Continued 


Adapter ROM | 
The read-only memory on the adapter, which contains code to control the 
adapter device. An adapter is a peripheral card that extends the operation 
of the system. For example, a fixed disk drive controller is an adapter that 
may have an adapter ROM. Adapter ROM code may include an ABIOS ROM 
extension. 

Address Bus : 
A set of signals which select a certain cell of memory or a certain device 
from the microprocessor to all parts of the system. 

Anchor Pointer 
A segment or selector with an assumed offset of zero, which is passed to 
the ABIOS on each request made of the ABIOS. It points to the real mode 
Common Data Area. 

Arbitration 
Arbitration is a process through which devices compete for possession of 
the channel on a prioritized basis. 

Arbitration Level 
Arbitration levels are the levels of priority assigned to devices that compete 
for possession of the channel. 

Bimodal Operation 
Refers to the ability of a program to operate in both the real address mode 
and the protected address mode of the 80286, 80386SX, or 80386 micropro- 
cessor. ABIOS services are bimodal; they operate in either real or protected 
mode. 

BIOS | 
Basic Input/Output System. Systems software that interfaces between the 
operating system and hardware. 

Boot 
Process of starting the computer. 
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Glossary, Continued 


Burst Mode | 
Burst mode is a method of DMA transfer that allows a device to remain in- 
active for long periods and then send large amounts of data in a short time. 
Bus 
One or more lines (conductors) that carry signals or power. 


Byte 
Eight contiguous bits; a bit is the smallest item of information that a com- 
puter can process. 

Cache 
Method of using a fast device to speed up access to a slow device. 


CBIOS 
Compatibility BIOS. The traditional single—tasking portion of a PS/2- 
compatible BIOS. 

CBIOS Service 


A software routine that services a given peripheral device, and provides an 
interface between the operating system and the hardware. These services 
are single task, call/return functions, as opposed to the device services 
offered by ABIOS. 


CMOS 
Acronym for Complementary Metal Oxide Semiconductor. In PS/2 compat- 
idles, it is low-power memory that is battery-backed and therefore not lost 
when the computer is turned off. 
Common Data Area | 
Contains a master list of pointers to the Function Transfer Table, Device 
Block, and Data Area (if any) associated with each ABIOS device service. 
Configuration 


The process of setting up all the parts of the computer so they run 
effectively. 
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Glossary, Continued 


Continuous Multistaged Requests 
ABIOS functions that never reach a completion point but are continually 
repeated. They can be thought of as standing function calls. An example is 
the ABIOS Keyboard Service Get Key Function. : 

Cyclic Redundancy Check (CRC) 
A method of redundancy check where the check key is produced by a cyclic 
or repeating algorithm. A common means of error checking. 

Default 
A value, setting, or option that is assigned by the program or system. 


Device Block | 
A permanent work area for each ABIOS device, containing hardware port 
addresses, interrupt levels, and device status information. 

Device ID 
Each type of device is identified to the system by a device ID. 


Direct Memory Access (DMA) 


Direct Memory Access is a means for I/O devices to transfer data directly to 
and from system memory without the intervention of the microprocessor. 
This significantly decreases I/O processing by the microprocessor. 


Discrete Multistaged Requests 


An ABIOS function that requires a significant amount of time while waiting for 
a hardware interrupt or time interval to occur returns control to the proces- 
sor between stages of servicing a request. An example is the ABIOS Diskette 
Service Diskette Read Function. 


DMA Controller 


A DMA controller is a device which gives addresses and control signals to 
the device that has won the bus through arbitration. The controller does not 
enter into the arbitration itself. | 


DMA Device 


A DMA device enters into arbitration for the channel. If it wins, it receives 
addresses and control signals from the DMA controller so it can read or 
write data. 


continued 
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Glossary, Continued 


DOS 
Acronym for Disk Operating System and short for PC-DOS and MS-DOS. 
DOS, like other operating systems, organizes the files and memory for other 
programs. 


Error Handler 
An invisible program on the Reference Diskette that reads the POST error 
log. If an error is found, a cause and solution type message about the error 
is displayed. 


Expanded Memory 
For AT-compatible systems, up to 32 MB of additional “paged” memory 
above the DOS 640K limit. Application programs written according to LIM 
EMS or AST EEMS specifications can use this type of memory. Examples of 
such programs are Lotus 1-2-3, Symphony and Framework. 


Expanded Memory Specification (EMS) 


For AT-compatible systems, a specification and protocol established by a 
consortium of computer manufacturers, principally Lotus, Intel, and Microsoft 
(LIM), which establishes a set of rules for organizing and accessing ex- 
panded memory. 


Extended Expanded Memory Specification (EEMS) 


A specification and protocol established by a consortium of computer and 
software manufacturers, principally AST, Quadram, and Ashton-Tate, which 
establishes a set of rules for organizing and accessing expanded memory. 


Extended Memory | 


The memory above 1 MB. XENIX and IBM’s VDISK can use this memory, but 
DOS and almost all application programs cannot, since use of the protected 
mode of the Intel 80286 or 80386 microprocessor is required. 


Fixed Disk (Hard Disk) 
A magnetic storage device consisting of a drive mechanism with perma- 
nently installed metallic disks; a “filing cabinet” for the computer. 
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Glossary, Continued 


Function Transfer Table 


A data structure that contains a list of pointers to the entry routines and 
function start addresses of one ABIOS service. There is a Function Transfer 
Table for each ABIOS service. 


Hardware 
The physical equipment and components in the computer system. 


Initialization Table 


An ABIOS common data structure that defines initialization data for each 
device in the system. It is referred to when initializing each Device Block and 
Function Transfer Table. 


Interrupt 


The suspending of microprocessor program execution by a demand for at- 
tention coming from a peripheral device. After the interrupt has been serv- 
iced, the suspended microprocessor task can be resumed where it was 
broken off by the interrupt. 


Kilobytes (K) 
1024 bytes. 


Known State 


When a device is initialized or reset, and then set to a particular pre—_ 
established condition, it is said to be in a known state. 


Logical Device 


A conceptual, as opposed to physical, identification of a hardware device by 
an operating system, so as to allow the latter a greater degree of device 
independence. Operating systems commonly identify physical devices with 
an operating system—assigned Logical ID number. Contrast with Physical 
Device. 


Logical ID 


An identifier for a device controller used by ABIOS. There may be several 
devices (units) attached to a Logical ID. The Logical Device ID (Logical 
ID/LID) is used by the operating system as an index into the Common Data 
Area to locate the Device Block pointer and Function Transfer Table pointer 
pair with which each ABIOS service is associated. 
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Glossary, Continued 


Low Level Format 


Electronic equivalent of drawing a detailed street map on the fixed disk. The 
electronic markings tell the system at what points to start and end reads 
and writes. 


Main Memory 
The memory between O and 1 MB. 


Megabyte (MB) 
One million bytes. 


Memory 


A device that can store data recorded in it and from which the data can be 
retrieved. 


Micro Channel 


Information is exchanged between the computer system board and the 
adapter cards which are plugged into it by means of the “bus.” Micro Chan- 
nel refers to the particular bus design in a PS/2-—compatible computer. It is 
also referred to as MCA, for Micro Channel Architecture. 


Microprocessor 
Central processing unit, or “brain” of the computer. 


Multitasking 


Multitasking programs execute multiple program modules simultaneously. 
Information input into one module does not need to be processed completely 
before information can be input into another module. ABIOS supports multi- 
ple concurrent requests. 


Offset 
A method of addressing that defines an address as relative to the beginning 
of a memory segment. 

Operating System 


Generic systems software which controls the execution of applications 
software. 
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Glossary, Continued 


Option Diskette 


The diskette provided by manufacturers of adapter cards that contains 
adapter description files (ADFs), which are written to the Reference Diskette 
and used by it to configure the system. 


Parameter 
Value, option, or setting that can be set in two or more ways. 


Physical Device 


A hardware device that physically exists in a system configuration. Physical 
devices are identified by a device ID. Contrast with logical device. 


Power-on Self Test (POST) 
A program that tests all parts of the computer every time you turn on the 
computer. . 

Private Data 


The ABIOS data structures contain areas (private data) which have informa- 
tion that is not available to ABIOS callers. This information includes hard- 
ware device support levels, ABIOS internal routines, and ABIOS internal 
parameters. : 


Program 
A set of instructions defining the operations of a computer in order to 
achieve the desired results. 

Programmable Option Select (POS) 


A way of setting up peripheral devices on a PS/2 machine via the power- 
on self test (POST), in which values are placed in registers on the devices. 
This software set up routine replaces the traditional switches and jumpers 
on devices. 
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Glossary, Continued 


Protected Virtual Address Mode (Protected Mode) 


One of two 80286 or three 80386 memory addressing modes. In protected 
virtual address mode, the 80386/80286 uses all address lines. This allows 
addressing of up to 16 megabytes of physical memory in an 80286 and 4 
GB in an 80386. The 80286 processor’s internal memory management allows 
addressing of an additional 1 gigabyte of virtual memory in protected mode 
(the 80386 up to 64 Terabytes). Protected mode addresses are specified in 
selector:offset format. ABIOS data structures support protected mode ac- 
cess of all ABIOS services. 


PS/2-—Compatible Computer 


Any computer that can run software programs written for an IBM PS/2 
computer. IBM PS/2 systems come in two basic varieties: Models 25 and 30 
versus Models 50, 60, and 80. The former systems do not implement the 
Micro Channel Architecture (MCA). 


Public Data 


That part of an ABIOS data structure which is accessible by the calling 
program (or the operating system). 


RAM Extension 


An extension to ABIOS that exists as files that will be located and initialized 
into system RAM during the overall ABIOS ROM initialization process. It can 
add or replace whole ABIOS services or individual functions. 


Real Address Mode 


One of two 80286 memory addressing modes (the 80386 has three). In real 
address mode, the 80286 and 80386 microprocessors use 20 address lines, 
thus allowing memory addressing of up to 1 megabyte of physical memory 
(220). Real address mode does not support virtual memory addressing. Real 
mode addresses are specified in segment:offset format. ABIOS data struc- 
tures support real mode access of all ABIOS services. 


Reentrant Code 


Reentrant code allows one copy of a given routine to be entered multiple 
times. Input #1 need not be completely processed before input #2 is al- 
lowed. Input #2 need not be completely processed before input #3 is al- 
lowed, and so on. All ABIOS code is reentrant. 
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Glossary, Continued 


Reference Diskette 


In PS/2-compatible MCA-based systems, POST error recovery, access to 
system utilities, and system configuration are all controlled by a utility disk- 
ette, the Reference Diskette. The Reference Diskette can automatically 
configure a system, resolving conflicts between adapter card settings, and 
optimally configuring the system. 


Revision Level 


The ABIOS ROM contains a ROM revision number that identifies the revision 
level of the ABIOS device services contained in the ROM. By convention, 
ABIOS extensions must examine the Device ID/Secondary Device ID pair 
associated with the service they are extending. It is the extension’s re- 
sponsibility to insure that only the service with the highest revision number 
is initialized. 

ROM Extension 
An extension to ABIOS that exists in the same peripheral card ROM that 
contains its CBIOS counterparts. It contains manufacturer—specific ABIOS 


device services, and is located and initialized as part of the overall ABIOS 
ROM initialization process. 


secondary Device 


An additional field used by the ABIOS to make sure that the selected de- 
vice’s hardware level is supported. 


Secondary Device ID 


When more than one physical device is associated with a device ID, the two 
physical devices can be differentiated with a Secondary Device ID. When a 
unique ABIOS Service is required for each physical device, the two services 
must be differentiated via their Secondary Device ID. 


Segment 


A unit of contiguous, one-dimensional address space. In real mode, these 
address blocks are 64K in size, referenced by one byte. In protected mode, 
_ programs can allocate segments of any size they require up to 64K. 
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Glossary, Continued 


Selector 


A value contained in a segment register (such as the CS, DS, SS, or ES 
segment registers) when in protected mode. This value determines what 
segment is currently being used; e.g., with CS, what segment is being used 
for executing code. 


Single-Tasking 
Single-tasking programs can only execute one program module or routine at 
a time. Information input into a module or routine must be processed com- 
pletely before information can be input into another module. 

Software 
A comprehensive term used to identify all of the nonhardware components 
of a computer. Software includes computer programs and data. 

System Board 
A large circuit board that holds most of the main electronic parts of the 
computer. 

System Board ROM 


Read-only memory chips that reside on the system board and provide 
control information for various system components. 


System Parameter Table 
A common ABIOS data structure 20h bytes long that describes the number 
of devices available in the system, the ABIOS common entry points, and 
system stack requirements. 

Task 
In an 80386, a task is the execution of a single process or set of instruc- 
tions to perform a particular function. It is not the same as an operating 
system task. 

Time-Out 
When the interval of time expected for a certain process (an interrupt) to 
occur is exceeded. 

Virtual 8086 Mode (80386 only) 


A way of emulating the 8086 or 8088 microprocessors on the 80386. The 
8086 program runs in protected mode as a task that can run with multiple 
8086 virtual tasks, as well as alongside other multiprogrammed 80386 tasks. 
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Additional Resources 


The following books provide additional material related to the ABIOS: 


Dettman, Terry R. DOS Programmer’s Reference. Carmel, IN: Que® 
Corporation, 1988. 


Duncan, Ray. Advanced MS-DOS Programming. Redmond, WA: Microsoft 
Press, 1986. 


Duncan, Ray. /BM® ROM BIOS. Redmond, WA: Microsoft 
Press, 1988. 


International Business Machines Corporation. /BM® Personal System/2™ and 
Personal Computer BIOS Interface Technical Reference. Boca Raton, FL: 
IBM, 1987. 


International Business Machines Corporation. [BM® Personal System/2™ 
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Index 


A 


Abbreviations, xxiii-xxiv 


ABIOSCall service, 2, 19, 23, 131, 
151, 155 


ABIOSCommonEntry service, 2, 
19-22, 131, 151-154 


ABIOS.SYS file, 27, 160 


Abort DMA Operation service, 
561-562 


Access. See Program access 


ACK byte from keyboard controller, 
300 


Acronyms, xxiii-xxiv 
Action, return codes requiring, 618 


Adapters 

card identification for, 55 

CMOS RAM for, 527-530 

description files for, 34, 55, 
570-571 

and POS data, 69, 579-582 

ROM extension for, 108 

slots for, 55 


ADD extension class, 163, 165, 174 
Address fields for diskettes, 214 


Address line 20 
disabling of, 482 
enabling of, 481 


Address modes. See Protected ad- 
dress mode; Real address mode 


Addresses 
for CMOS RAM, 443-445 
changing 
Global Descriptor Table and pro- 
tected mode, 478 


index 


for fixed disk systems, 233 
for 1/O ports, 61-79 
parallel, 39, 70-71, 74-75, 417 
POS, 67, 69-70, 572 
serial, 40, 71-73, 77-79, 361 
for PiCs, 56 
for system control functions, 58-59 
for video RAM, 309 


ADF (adapter description files) for 
POS data, 34, 55, 570-571 


Alarm interrupts, 441 
canceling of, 457 
setting of, 454-456 


Allocate Arbitration Level DMA 
service, 556-557 


Alt key, 266-267, 587 


Alternate Reset Fixed Disk System 
function, 232 


Analog monitor support, 37, 308 


Anchor pointer 
to CDA, 85-86 
and program access, 19-20, 151 
relationship of, to other structures, 
14 


Arbitration levels 
allocation of, 556-557 
and bus sharing, 545 
deallocation of, 558 
disabling of, 559 
for DMA, 51-53, 548-550 
for multiple instances of devices, 
115-116 
register for, 67 


Arbus register in DMA controller, 49, © 
53, 551 
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A, cont'd 


Arithmetic calculations, coprocessor 
for, 32 


Assignment of interrupt requests, 57 


Attention register,‘ fixed disk adapter, 
74 


Attention return code, 25, 141, 618 


Attribute bytes, video, 314 
controller for, 36, 307 
and palette register, 312, 345, 347 
registers for, 75 


Autoinitialization of DMA controller, 
49, 547 


Auxiliary device, enabling and dis- 
abling of, 296 


Banks, RAM, 37 
Base memory, CMOS RAM for, 526 


Battery-backed CMOS RAM. See 
CMOS RAM 


Battery Bad return code, 532 


Baud rate 
generator of, 41, 362 
setting of, 378-379 


Bimodal support for interrupt 
handlers, 146 


BIOS 
extensions, 157 
ROM 9 1 


Blocks, print | 
printing of, 427-431 


Blocks, video 
of color registers, reading of, 
354-355 


Booting and initialization, 12, 95 
Break Interrupt for serial ports, 392 
Break key, 267, 589 
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Buffers, serial port | 
receive, 389-391, 393-396 
transmit, 379-382, 384-386, 399 


Buffers, video 
video, size parameters for, 321 


Build Initialization Table function, 13, 
96, 100-102 
for RAM extensions, 178-179 
for ROM extensions, 177 


Build System Parameters Table 
function, 13, 96, 98-99 
for RAM extensions, 179 
for ROM extensions, 177 


Burst mode DMA transfer, 51, 548 
Bus sharing for DMA, 47, 545 


BUSY signal, math coprocessor, 
32-33 


C 


CALL for control transfer, 17, 134 


Calling of functions, 127 

and ABIlOSCall, 155 

and ABIOSCommonEntry, 152-154 

control transfer, 134-135 

Default Interrupt Handler for, 
147-148 

by handlers, 9 

hardware interrupt handlers for, 
142-146 

processing model for, 128-131 

and program access, 151 

and Request Block initialization, 
132-133 

return code handling in, 139-141 

time-out handlers for, 149-150 

and transfer conventions, 136-138 


Cancel Alarm Interrupt Real Time: 
Clock Service, 457 


Cancel Periodic Interrupt Real Time 
Clock Service, 461 


Cancel Print Block Parallel Port 
Service, 430-431 
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C, cont’d 


Cancel Serial Communications 
Service, 407-408 


Cancel Update-Ended Interrupt Real 
Time Clock Service, 464 


Capacity, diskette, 193 


Card selected feedback register, 
DMA, 67 


CBIOS 
accessibility to, 2 
and compatibility, 1 
and Diskette Service, 189-190 
extensions for, 158 
and Fixed Disk Service, 232, 245 
and serial ports, 367 
structures of, Compared to ABIOS, 
11 


CDA. See Common data area 


Central Arbitration Control 
for DMA controller, 549 
with Micro Channel, 33, 51 


CGA (Color Graphics Adapter) 
compatibility with, 309-310, 325 
and palette register, 312 


Change Line Status signal, 191 
emulation of, 186-188 
reading of, 226-227 
testing of, 204 


Channel extension connectors, 33 


Channel position select register, 


Channels, DMA, 54, 551 
flags for, 53, 551 


Character Block Specifier field, 
319-320 


Character block to load field, 327 
Character block to select field, 328 


Characters 
blocks of, selection of, 337-338 


Index 


and fonts, 314 
generators of, 313 


serial support for number of, 
40, 361 


Checksum 
power-on, CMOS RAM for, 528 
recomputation of, 540-541 


Checksum Invalid return code, 532 
Clear Byte Pointer, DMA, 61, 69 
Clear Mask Register, DMA, 62, 69 
Clear video buffer flag, 326 

Clock generator chip, 42 

Clock interrupts, 441 


CMOS RAM 
ADF file data stored on, 34, 55 
areas for, 46 
device ID for, 4, 153 
data for, 525-527 
error handling for, 532 
for Error Log Service, 607-608 
extended, 528-531 
hardware environment for, 524 
and NMis, 449 
port addresses for, 66 
and POS, 569, 575-582 
for power-on password, 60, 583 
reading of, 45 
for real time clock, 45, 443, 
524-525 
return codes for, 620 
services for, 523 
Read CMOS RAM, 536-537 
Read Device Parameters, 534 
Recompute Checksum, 540-541 
Return Logical ID Parameters, 
533-534 
Write to CMOS RAM, 538 
writing to, 45 


Color Graphics Adapter 
compatibility with, 309-310, 325 
and palette register, 312 
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C, cont’d 
Color register 
reading of, 349-350, 354-355 
writing to, 351-353, 356-358 


Colors, video, 309-311, 325 
default, 313 


Common Data Area, 10, 84-86 

and Anchor Pointer, 19 

building of, 103-105 

and control transfer, 18, 135-136 

data pointers in, 85-86, 103, 107, 
109, 113, 475 | 

in DB and FIT initialization 
routines, 108 

device data pointers in, 107 

and extensions, 173-174 

and initialization, 11-13, 95 

and Initialization Table, 100-101 

Logical IDs in, 15, 152 

null entries in, 85, 112 

and program access, 151 

and protected mode, 110-112 


relationship of, to other structures, 


14, 82 7 , 
and REPLACE extensions, 164 
for stack frame loading, 137 


Common Entry Routines, 9 17-18 
and control transfer, 18, 134-135 
device service for, 109 
with function calling, 131 
logical ID for, 104-105 


Common Interrupt Routine, 9 
address of, 113 
with function calling, 131 
pointer for, 98 
for time-out handlers 


Common Start Routine, 9 
address for, 113 
and control transfer, 18 
with function calling, 131 
pointer for, 98 


Common Time-out Routine, 9 
address of, 113 
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” 


with function calling, 131 

pointer for, 98 
Compatibility, 1-2 

diskette, 194-195 

video display, 36 

video RAM, 308 


Configuration 
for CMOS RAM, 525-531 
diskette drive, 35 
system, reading of, 473-474 


Configuration control register, diskette 
controller, 77 


Conforming Bit for pointers, 111 
Connectors for Micro Channel, 34 


Continuous Keyboard Read service, 
280-281 


Continuous multistaged functions, 6 
processing model of, 128 


Continuous read, NMI, 492-493 
Control. See Transfer conventions 


Control addresses for parallel ports, 
39, 417 


Control keys, 266, 588 
Control Port, address for, 71, 74-75 


Control register, fixed disk adapter, 
73 


Control word register, PIT, 65 


Controllers 
CRT, 36, 74, 76, 307 
diskette, 35, 193 
DMA, 545-546 
fixed disk, 35, 57, 235 
keyboard, 38, 261 
serial port, 361 


Coprocessors, 32-33 
interrupt request for, 57 
port address for, 69 ~ 


Count control for DMA controller, 
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C, cont’d 
CPU 


clock generator for, 42 
and functions, 5 


CRT controller, 36, 307 
index register for, 76 
port addresses for, 74, 76 


Current Serial Port Status field 
for receive, 389-390, 392-396 
for transmit, 380, 382-386 


Cursor 
in graphics modes, 310, 326 
keys for, 266, 588 
size of, and fonts, 342 


Cylinders, fixed disk, 236-237 


D 


DAC. See Digital-to—analog converter 


Data addresses for parallel ports, 39, 
70, 74-75, 417 


Data length, changing of, 202 


Data pointers 

in CDA, 85-86, 103, 107, 109, 113, 
475 

for CMOS RAM, 536, 538 

in Initialization Table, 101 

relationship of, to other structures, 
14 

in Request Block structure table, 
123-124 


Data registers, diskette controller, 76 


Data string length for keyboard 
controller, 295 


Data structures, 10-11, 81-83, 94 
Common Data Area, 84-86 
Device Block, 89-93 
Function Transfer Table, 87-88 


Data transfer 
diskette rates for, 193 
with DMA devices, 50 


Index 


for fixed disk systems, 235 


Date 
reading of, 465-466 
writing of, 466-467 


Daylight Savings Update field, 452 
DB. See Device Blocks 


Deallocate Arbitration Level DMA 
Service, 558 


Default colors, 313 
Default fonts, 310, 314, 325, 327-328 


Default Interrupt Handlers, 4, 144, 
147-148 
for Diskette Service, 196 
for Fixed Disk Service, 239 
for Keyboard Service, 269 
for Parallel Port Service, 419 
for Pointing Device Service, 498 
for Real Time Clock Service, 446 
for Serial Communications Service. 
364 
for System Timer Service, 438 
for Video Service, 316 


Default sector size, changing of, 202 
Defect map, fixed disk, 236-237 | 
Delay, typematic, 286-288 
Descriptors, selector, 111 

DevHip services, 2, 19-23, 131, 151 


Device Blocks, 10, 82, 89-93 
and ADD extensions, 165 
and control transfer, 18, 135-136 
for extensions, 26, 159, 173-175 
initialization of, 11-13, 96, | 
106-109, 113 
and Initialization Table, 100-101 
and MODIFY extensions, 167 
for multiple instances of devices, 
115-116 
pointers to, 84-86 
characteristics of, 111 
initialization of, 103 


645 


D, cont’d 
and Logical IDs, 15 
protected mode, 110 
relationship of, to other structures, 
14 | 
for REPLACE extensions, 164 
Device Control Flag, 326, 356 
Device Error return code, 25, 141 


Device Error With Time-out return 
code, 25, 141 


Device IDs, 15, 21 
and ABlIOSCommonEntry, 152 
CDA for, 85 
in Device Block, 90, 93 
for extensions, 169 
in Initialization Table, 100 
in Return Logical ID Parameters 
function, 20 


Device In Use return code, 25, 141 


Devices 

bit size of, and DMA controller, 50 

CDA data pointers for, 85 

data area for, in Device Block, 92 

extensions for, 162 

memory for, 14 

multiple instances of, 115-116 

return codes for, 25, 139-141 

supported, 4, 21 

See also Device Blocks; Device IDs; 
Read Device Parameters 
functions 


Diagnostic status for CMOS RAM, 525 


Digital input register, diskette 
controller, 77 


Digital output register, diskette 
controller, 76 


Digital-to—analog converter, 36-37, 
307-308 | 
and palette register, 312, 345, 347 
port addresses for, 75 
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reading of color register in, 
349-350 

writing to color register in, 
351-353, 356-358 


Direct Memory Access Service, 47, 
50, 543-544 
device ID for, 4, 153 
error handling for, 552 
for. fixed disks, 231 
hardware environment for, 545-552 
return codes for, 619-620, 622 
services for, 553-568 
Abort DMA Operation, 561-562 
Allocate Arbitration Level, 
556-557 
Deallocate Arbitration Level, 558 
Disable Arbitration Level, 559 
DMA Transfer from Memory to 
I/O, 563-564 
DMA Transfer Status, 560 
Load DMA Controller Parameters, 
567-568 
Read Device Parameters, 555 
Read from |I/O and Write to 
Memory, 565-566 
Return Logical ID Parameters, 
553-554 
See also DMA controller 


Disable Address Line 20. System 
Services, 482 


Disable Arbitration Level DMA 
Service, 559 


Disable Diskette Service, 206-207 
Disable Keyboard Service, 278-279 
Disable NMI Service, 491 


Disable Pointing Device Service, 
507-508 | 


Disable standard function, 4 
Discrete multistaged functions, 6, 128 
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D, cont’d 
Diskette Change Line signal, 191 
emulation of, 186-188 
reading of, 226-227 
testing of, 204 


Diskettes 
change line emulation for, 186-188 
CMOS RAM for, 526 
controller registers for, 76-77 
device ID for, 4, 153 hardware for, 
35, 193 
error handling for, 195 
interrupt request for, 57 
return codes for, 619-626 
services for, 189-192 
Default Interrupt Handler, 196 
Disable Diskette, 206-207 
Format Diskette, 214-217 
Interrupt Status, 229-230 
Read Change Line Signal Status, 
226-227 
Read Device Parameters, 
199-201 
Read Diskette, 208-210 
Read Media Parameters, 221-222 
Reset/Initialize Diskette 
Subsystem, 203-205 
Return Logical ID Parameters, 
197-198 
Set Device Parameters, 202-203 
Set Media Type for Format, 
223-225 
Turn Diskette Motor Off, 228-229 
Verify Diskette Sectors, 218-220 
Write to Diskette, 211-213 
support for, 116 


Divisor latch, serial port, 71, 77 


DMA controller, 47-54, 545-546 
arbitration levels for, 33, 52 
direct accessing of, 50, 547 
port addresses for, 61, 66, 68-69 
See also Direct memory access 


Index 


DMA Transfer from Memory to 1/O, 
563-564 


DMA Transfer Status, 560 


Door, diskette, and Diskette Change 
Line signal, 191 


DOS, ROM BIOS interrupt vectors for, 
157 


DOS compatibility box, 22-23, 
154-155 


Double density diskettes, 194 
Drive types, diskette, 194 


Dynamic reassignment of arbitration 
levels, 53, 551 


E 


EGA (Enhanced Graphics Adapter) 
compatibility with, 309-310, 325 
and palette register, 312 


Emulation 
of Change Line Status signal, 
186-188 
of video modes, 310, 325 


Enable Address Line 20 System 
Services, 481 


Enable FIFO Control Serial Communi- 
cations Service, 412-413 


Enable Keyboard Service, 276-277 


Enable Keyboard Security Service, 
593-594 


Enable NMI Service, 490 


Enable Pointing Device Service, 
505-506 


Enable Speaker System Services, 
483-484 


Enable standard function, 4 
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E, cont’d 
Enabling of transmit interrupts, 379 
End-of-interrupt processing, 144 


Enhanced Graphics Adapter 
compatibility with, 309-310, 325 
and palette register, 312 


Enhanced Load Text Mode Font Video 
Service, 342-344 


Entry pointers for control transfer, 
17, 134 


Entry points 
for extensions, 168-169 
vectors to, 87-88 


Entry routines for transferring control, 
9, 17, 131 


Environment. See Hardware 
environment 


EOI rie processing, 
144 


Equipment installed, CMOS RAM for, 
526 


ERRNUM pointer, 607 


Error handling 

for CMOS RAM Service, 532 

of DBs and FTTs, 108 

for Direct Memory Access 
Service, 552 

for Diskette Service, 195 

for Error Log Service, 609 

for Fixed Disk Service, 238 

for Keyboard Security Service, 589 

for Keyboard Service, 268 

for math coprocessor, 32-33 

for Nonmaskable Interrupt Service, 
487 

and operating system transfer 
convention, 138 

for Parallel Port Service, 418 

for Pointing Device Service, 497 

for POS Service, 573 

for Real Time Clock Service, 445 — 
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for Serial Communications 
Service, 363 

for switching to protected mode, 
480 

for switching to real mode, 477 

for System Services, 470 

for System Timer Service, 437 

for Video Service, 315 


Error Log Service 
CMOS RAM for, 531 
device ID for, 4, 153 
error handling for, 609 
extended CMOS RAM for, 607-608 
services for, 605-606 
Read Error Log, 612-613 
Return Logical ID Parameters, 
610-611 
Write to Error Log, 614-615 


ESDI fixed disk controller, 35 


Expansion memory, CMOS RAM for, 
526, 528 


Extended CMOS RAM 
data area for, 46, 524 
for Error Log Service, 607-608 
port address for, 66 
for POS Service, 569 
services for, 528-531 


Extended function execute register, 
DMA, 62 


Extended function register, DMA, 62 


Extended mode 
DMA, 54, 552 
parallel port, 39, 417 


Extensions, 26-27, 157-161 

Device Block and FTT routines for, 
173-175 

examples, 180-188 

headers for, 168-170 

and initialization, 108-109, 117 

Initialization Table entry routine for, 
171-172 

non-intrusive interception, 181-183 
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E, cont’d 
nonstaged function, redirection of, 
184-185 
RAM, 178-179 
recommendations for, 162-167 
ROM, 176-17 
service code for, 176 


staged function, redirection of, 
186-187 


F 


Feature Configuration Table, 473 
Feature control register, VGA, 74-76 


FIFO control, 412-413 
serial port register for, 72, 78 


File headers for extensions, 26, 159, 
168-169 


Filter bytes, writing of, 601-604 


Fixed Disk Interrupt Status service, 
257-258 


Fixed disks 
adapters for, 73-74 
CMOS RAM for, 526 
controller for, 35, 57, 235 
device ID for, 4, 153 
DMA arbitration level for, 549 
error handling for, 238 
extensions for, 163 
hardware environment for, 235 
parameters table for, 236-237 
port address for, 70 
return codes for, 620-626 
services for, 231-234 
Default Interrupt Handler, 239 
Fixed Disk Interrupt Status, 
257-258 
Read Device Parameters, 
242-244 
Read Fixed Disk, 249-250 


Index 


Reset/Initialize Fixed Disk, 
244-248 

Return Logical ID Parameters, 240 

Verify Fixed Disk Data, 255-256 

Write and Verify Fixed Disk, 
253-254 

Write to Fixed Disk, 251-252 


Flags 
Device Control, 326 
in DMA controller, 48, 53, 546, 551 
for DOS compatibility box, 22, 154 
for Start Routines, 143 


Floating point numbers, coprocessor 
for, 32-33 | 


Fonts 
default, 310, 314, 325, 327-328 
extension for, 184-185 
retrieval of information about, 
331-332 
ROM-resident, 313-314, 327 
text mode, 325, 339-344 


Format Diskette Service, 214-217 


Framing errors for serial ports, 392 
FTT. See Function Transfer Tables 
Function count in FTT, 88 

Function Pointers, relationship of, 14 


Function Transfer Tables, 10, 82, 

87-88 

and control transfer, 135 

for extensions, 26, 173-175 

initialization of, 11-13, 103, 

106-109, 113 

and Logical IDs, 15 

pointers to, 17-18, 84-85 
and ADD extensions, 165 
characteristics of, 111 
and control transfer, 18, 136 
for extensions, 159, 162, 173-175 
and initialization, 95 
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F, cont’d 


and Initialization Table, 100-101 

Logical ID 2 entry in, 114 

and MODIFY extensions, 167 

and protected mode, 111-112 

relationship of, to other 
structures, 14 

for REPLACE extensions, 164 


relationship of, to other structures, 
14 | 


Functional parameters, Request 
Block, 121-123 


Functions 
address pointers to, 82 
entry points for, extensions control 
of, 26 | 


relationship of, to other structures, 


14 
and request blocks, 15, 122 
standard, 4 
suspension of, 5, 22-23, 154 
transferring control to, 17-18 
See a/so Calling of functions 


G 


Game port address, 70 

Gap length, changing of, 202 
Graphics controller, 36, 307 
Graphics registers, VGA, 75 

Gray scale summing flag, 326, 356 


H 


Handlers, calling by, 9 


Hardware devices 
as physical devices, 15 


relationship of, to other structures, 
14 


Hardware environment, 29-30 
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for CMOS RAM Service, 46, 524 

for Direct Memory Access Service, 
545-552 

for Diskette Service, 193-195 

DMA controller, 47-54 

for Fixed Disk Service, 235 

I/O devices, 35-42 

I/O port list, 61-79 

for Keyboard Security Service, 585 

for Keyboard Service, 261 

math coprocessors, 32-33 

Micro Channel, 33-34 

Microprocessors, 31 

NMI masks, 60 

for Parallel Port Service, 39, 
417-418 

for Pointing Device Service, 497 

for POS Service, 571-572 

power-on passwords, 60 

Programmable Interrupt Controller, 
56-57 

Programmable Option Select, 55 

for Real Time Clock Service, 443 

for Serial Communications Service, 
40-41, 361-363 

system control port definitions, 
58-59 

system time-related devices, 42-46 

for System Timer Service, 436-437 

for Video Service, 36-37, 307-308 


Hardware interrupts 


for Diskette Service, 193 

for fixed disks, 35 

handlers for, 142-146 

maskable, PICs for, 56 

for multistaged functions, 7-8, 
129-130 

for parallel ports, 39 

by PIT, 43 

sharing of, 144-145 


Hardware time-out 


for function driving, 130 
vs. time period stages, 8 


ABIOS for IBM PS/2 Computers and Compatibles 


H, cont’d 


Headers for extensions, 26, 159, 
168-169 


Heads 
fixed disk, 236-237 
number of, in disk formatting, 214 


High density diskettes, 194 


Identification code 
for keyboard, 272 
for pointing devices, 519-521 


Identity BIOS service, CBIOS vs. 
ABIOS, 11 


Idle CPU time, 5 
IDs. See Device IDs; Logical IDs 


Initialization, 95-97, 117 

ABIOS, 11-16 

of Common Data Area, 96, 
103-105 

of DAC color registers, 349, 351 

of Device Blocks and FTTs, 11-13, 
96, 106-109, 113 

of Initialization Table, 96, 100-102 

of logical ID 2, 113-115 

and multiple instances of devices, 
115-116 

of palette register, 345 

of Pointing Device Service, 503 

of protected mode tables, 96, 
110-112 

of RAM extensions, 178-179 

of Request Block, 11, 132-133 

of return code fields, 143 

of ROM extensions, 176-177 

of serial ports, 361 

of stack frames, 20, 23 

of System Parameters Table, 96, 
98-99 

of video hardware, 324-330 


Initialization Command Words, PIC, 63 


Initialization Table 


Index 


building of, 13, 96, 100-102 

for extensions, 26, 159, 168, 
171-172 

first Device ID entry for, 114 


Initialize DAC to default values flag, 
326 


INMOS G171 DAC chip, 36, 307 


Input rules for Request Blocks, 
16, 133 


Input status register, VGA, 74, 76 
Intel 8042 keyboard controller, 
38, 261 
for keyboard security, 585 
for Pointing Device Service, 497 
port address for, 66 


Intel 8237 DMA Controller, 47, 
545-546 


Intel 8254A Programmable Interval 
Timer, 42-44, 436 

Intel 8259A Programmable Interrupt 
Controller, 56-57 


Intel 80286/80386/80386SX 
microprocessors, 31 


Intel 80287/80387 math coprocessor, 
32 


Intel 82284 clock generator, 42 


Internal calls 
device ID for, 4, 153 
and Logical ID 2, 113 
logical IDs for, 104 


Interrupt Status Diskette Service, 
229-230 


Interrupt status field, fixed disk, 257 


Interrupt Status Register, fixed disk 
adapter, 74 


Interrupts, 9, 131 
assignment of requests for, 57 
diskette handlers for, 196 
enable register for, 71, 77 
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3 Ree 


I, cont’d 


and extensions, 162 

identification register for, 71, 77 
levels of, 33, 39-40, 56, 261, 361 
mask register for, 63-64 

for multiple instances of devices, 


operating system handling of, 138 

pointer to, 87-88, 98 

for real time clock, 441 

for serial port, 361 

and service registers, PIC, 62 

and staged function redirection, 186 

update-ended, 462-464 

See a/so Hardware interrupts; 
Nonmaskable interrupts 


Invalid Function return code, 25, 141 


Invalid Logical ID return code, 
25, 141 


Invalid Request Block Length return 
code, 25, 141 


Invalid Service—Specific Parameter 
return code, 25, 141 


Invalid Unit Number return code, 
25, 141 


Invocation byte, writing of, 597-598 


(/O address width with Micro Channel, 
33 


I/O ports 
for CMOS RAM, 45, 66 
for diskette, 76-77 
for DMA controller, 47, 66, 68-69 
for error logs, 608 
for fixed disk, 70, 73-74 
for game port, 70 
for keyboard, 65-66 
for manufacturing checkpoint port, 
79 


for math coprocessor, 69 — 
for parallel port, 70-71, 74, 75 
for POS, 67, 69, 572 

for PIC, 62-64, 68, 572 
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for PIT, 64-65 

for serial port, 71-73, 77-79 

for video, 74-76 

See a/so Parallel ports; Serial ports 


I/O privileges, 112 
Isolation, BIOS for, 1 


Italicizing fonts, extension for, 
184-185 


K 


Keyboard 
device ID for, 4, 153 
error handling for Keyboard 
Service, 268 
error handling for Keyboard Security 
Service, 589 
hardware environment for Keyboard 
Security Service, 585 
hardware for, 38, 261 
hardware environment for Key- 
board Service, 261 
interrupt request for, 57 
layout of, 262 
return codes for, 619-622, 625 
services for Keyboard Security 
Service, 583-584 
Enable Keyboard Security, 
593-594 
Read Device Parameters, 592 
Return Logical ID Parameters, 
590-591 
Write Filter Byte 1, 601-602 
Write Filter Byte 2, 603-604 
Write Invocation Byte, 597-598 
Write Match Byte, 599-600 
Write Password, 595-596 
services for Keyboard Service, 
259-260 
Continuous Keyboard Read, 
280-281 
Default Interrupt Handler, 269 
Disable Keyboard, 278-279 
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Enable Keyboard, 276-277 
Read Keyboard ID Bytes, 272-273 
Read Keyboard LED Status, 
282-283 
Read Keyboard Scan Mode, 
289-291 
Reset/Initialize Keyboard, 274-275 
Return Logical ID Parameters, 270 
Set Keyboard LED Status, 
284-285 
Set Keyboard Scan Code Mode, 
292-295 
Set Typematic Rate and Delay, 
286-288 
Write Command(s) and Data to 
Keyboard, 300-303 
Write Command(s) to Keyboard 
Controller, 295-299 
scan codes for Keyboard Service, 
263-267, 586-587 
system scan codes for Keyboard 
Security Service, 586-588 
and time-out handling, 149 


Keyboard/auxiliary data port, 65 


L 


Landing zone, fixed disk, 236-237 
LED, keyboard, status of, 282-285 


Length 
data string, for Keyboard controller, 
295 
of extensions, 168 
in Request Block structure, 122 


Level—sensitive interrupts 
with Micro Channel, 33 
for parallel port, 39 
and PICs, 56 
and serial port, 40, 361 


Levels of priority for DMA controller, 
549 


index 


Lifespan of Request Blocks, 15, 132 


Line control 
register for, 72, 78 
setting of, 375-377 


Line status register, 73, 79 


Load DMA Controller Parameters 
service, 567-568 


Load Text Mode Font Video Service, 
339-341 


Local Descriptor Table and protected 
mode, 478 


Locate BIOS function and service, 
CBIOS vs. ABIOS, 11 


Logical devices vs. physical devices, 
15 


Logical ID 2, initialization of, 109, 
113-114 


Logical IDs, 15 
and ABlIOSCommonEntry, 20, 152 
and ADD extensions, 165 
assignment of, 103 
in bimodal environment, 146 
and CDA, 85-86, 104-105 
and control transfer, 135 
and Default Interrupt Handlers, 147 
in Device Blocks, 90-93 
for diskette drives, 190, 197-198 
for fixed disk systems, 232 
FTT pointer for, 87 
and hardware interrupt handlers, 

142 

in Initialization Table, 100 
interrupts for, 144-145 
and MODIFY extensions, 167 


for multiple instances of devices, 
115 


relationship of, to other structures, 
14 
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L, cont’d 
in Request Block structure table, 
122 
for serial ports, 40 
See also Device IDs; Return Logical 
ID Parameters functions 


M 


Manufacturers, fixed disk, 236-237 
Manufacturing checkpoint port, 79 
Mask register, DMA, 61, 68 


Maskable hardware interrupts, PICs 
for, 56 


Masks, NMI, 60 
Master Clear, DMA, 61, 69 
Match byte, writing of, 599-600 


Math coprocessors, 32-33 
interrupt request for, 57 
port address for, 69 


MDA (Monochrome Display Adapter), 
compatibility with, 309-310, 325 


Memory 
for CDA, 103, 110 
device, 14, 84 


for Initialization Table, 102 
transferring data from, 563-564 
transferring data to, 565-566 
video, 36-37, 307-308, 314 


Memory address registers, DMA, 61, 
68, 546 


Memory refresh, arbitration level for, 
52 


Messages, error. See Return Codes, 
Appendix A 


Micro Channel, 33-34 
arbitration levels for, 51 


Microprocessor mode and hardware 
interrupts, 146 


Microprocessors, 31 
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address line 20, 481-482 
and DMA, 50, 547 
system, arbitration level for, 52 
Miscellaneous output register, VGA, 
75-76 
Mode control field for DMA controller, 
49, 547 
Mode Register, DMA, 61, 69 
Model byte for extensions, 169 
Models, PS/2, identification of, 473 


Modem Status Serial Communications 
Service, 404-406 
Modems 
control register for, 72, 78 
controlling of, 374-375 
line status of, 409 
status register for, 73, 79 
See also Serial ports 


Modes 
keyboard scan, 289-294 
real time clock, 452 
system timer, 43 
video, 309-313, 324-330 
See also Protected address mode; 
Real address mode 


MODIFY extension class, 163, 
166-167, 174 


Monitor support, 37, 308, 311-313 


Monochrome Display Adapter, com- 
patibility with, 309-310, 325 


Motherboard IDs, reading of, 473 
See a/so system board 


Motor, diskette, 204, 228-229 


Motorola MC146818A Real Time 
Clock, 45-46, 443, 524-525 


Mouse, 495 
interrupt request for, 57 
return codes for, 619, 622 


Multi-byte scan codes, 264-265, 586 


Multiple instances of devices, 
115-116 
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Multiscan monitor support, 37, 308 


Multistaged functions, 7-8 
driving of, 129 
time-period handling of, 130 


Multistaged processing/multitasking 
operating systems, 5-6 


Multitasking operating system, 31 


N 


National Semiconductor 
8250/16640/16650 serial port 
controller, 40-41, 361 


NEC 765 diskette controller, 35, 193 
NMI. See Nonmaskable interrupts 


NMI Continuous Read service, 
492-493 


Non-intrusive interception by 
extensions, 181-183 


Nonmaskable interrupts 
arbitration level for, 52 
and CMOS RAM access, 449 
device ID for, 4, 153 
error handling for, 487 
mask for, 60 
services for, 485-486 
Disable NMI, 491 
Enable NMI, 490 
NMI Continuous Read, 492-493 
Return Logical ID Parameters, 488 


Nonstaged function, redirection of, 
184-185 


Not My Interrupt return code, 25, 
141, 143-144, 618 


Not set state for Diskette Change 
Line signal, 191 


Null CDA entries, 85, 112 
Null stripping serial port mode, 392 


Index 


Number of Initialization Table Entries 
for extensions, 168-169 
in Systems Parameters Table, 
98-99 


Numbering of logical IDs, 104 


Numeric exception error handling 
interrupt, 33 


Numeric keypad, 267, 588 


O 


Operating system 
CDA building by, 103-104 
and DBs and FTTs, 106, 109 
isolation of, by BIOS, 1 
transfer convention of, 18, 137-138 


Out of paper error, Parallel Printer 
Service, 427 


Output rules for Request Blocks, 
16,133. ~ 


Overrun errors for serial ports, 392 


p 


Page table address registers, 66 


Palette register 
and DAC, 312 
reading of, 345-346 
writing to, 347-348 


Parallel ports 

addresses for, 39, 70-71, 74-75, 
417 | 

device ID for, 4, 153 

error handling, 153 

hardware environment for, 39, 
417-418 

interrupt request for, 57 

return codes for, 619-620, 622, 
626 

services for, 415-416 

Cancel Print Block, 430-431 


655 


P, cont’d 


Default Interrupt Handler, 419 

Print Block, 427-429 

Read Device Parameters, 
421-422 

Reset/Initialize Parallel Port, 425 

Return Logical ID Parameters, 
420-421 

Return Print Status, 432-433 

Set Device Parameters, 423-424 


Parallel—to—serial Conversions, 
41, 362 


Parameters 
errors in, 140 
Request Block, 121 
table of, for Fixed Disk Service, 
236-237 


Parity, serial support for, 40, 361, 
392 


Pass parameters, CBIOS vs. ABIOS, 
11 


Passwords 
CMOS RAM for, 526, 528 
with keyboard, 296, 583-584 
power-on, 60 
writing of, 595-596 


Patching, recommendations for, 162 

Pause key, 267, 589 

PC-type adapters and Micro Channel, 
33 


Periodic Interrupt Rate field, 449 


Periodic interrupts, clock timer, 441 
canceling of, 458-460 
setting of, 461 


Phoenix 8042 Advanced Keyboard/ 
Mouse Controller Firmware, 
289, 292 


Physical addresses, conversion of, 
109 
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Physical devices 
vs. logical devices, 15 
supported, 153 


Physical DMA channels, 53, 551 
PhysToVirt call, 22 


PIC. See Programmable Interrupt 
Controller, 56-57 


PIO (programmed |/O) for DMA 
controller, 49, 547 


PIT. See Programmable Interval Timer 


Pointer field definitions, 379, 389 


Pointers | 
and CDA, 84-86, 103, 107, 109, 
113, 475 


for data area, 103 

to functions, 82 

pushing of, onto stack, 134 

receive, 389-391, 393-396 

transmit, 379-382, 384-386, 391, 
399 | | 

See also Anchor pointer; Device 
Blocks, pointers to; Function 
Transfer Tables, pointers to 


Pointing Device Continuous Read, 
509-511 | 


Pointing devices 
controller for, 38 
device ID for, 4, 153 
error handling for, 497 
hardware environment for, 497 
services for, 495-496 
Continuous Read, 509-511 
Default Interrupt Handler, 498 
Disable Pointing Device, 507-508 
Enable Pointing Device, 505-506 
Read Device Parameters, 
500-501 
Read Pointing Device Identification 
Code, 519-521 
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Reset/Initialize Pointing Device, 
503-504 
Return Logical ID Parameters, 
499-500 
Set Resolution, 514-515 
Set Sample Rate, 512-513 
Set Scaling Factor, 516-518 


Polling of Request Block, 142-143 


Port pairs, logical ID, in device block, 
91 


Portability, interface for, 30 


Ports 
for CMOS RAM, 45, 66 
for diskette, 76-77 
for DMA controller, 47, 66, 68-69 
for error logs, 608 
for fixed disk, 70, 73-74 
for game port, 70 
for keyboard, 65-66 
for manufacturing checkpoint port, 
79 
for math coprocessor, 69 
for parallel port, 70-71, 74, 75 
for POS, 67, 69, 572 
for PIC, 62-64, 68, 572 
for PIT, 64-65 
for serial port, 71-73, 77-79 
for video, 74-76 
See a/so Parallel ports; Serial ports 


POS. See Programmable Option 
Select 


Power-on passwords, 60 
for Keyboard security, 583 


Power-on self test (POST) 
ADF files read during, 34, 55 
password access during, 60 


Print Block Parallel Port Service, 
427-429 


Print screen key, 267, 589 


Printer, resetting of, 425 


index 


Printer Interrupt Time—out field, 421 


Printer Status, 425, 427, 430 
returning of, 432-433 


Private data in Device Block, 90 
Privileges, I/O, 112 
Processing model, 5-9, 128-131 


Program access 
with ABlOSCall, 2, 19, 23, 131, 
151, 155 
with ABIOSCommoneEntry, 19-22, 
131, 151-154 


Programmable baud rate generator, 
41, 362 


Programmable Interrupt Controller, 
56-57 
port addresses for, 62-64, 67-68 


Programmable Interval Timer, 42-44, 
436 
port addresses for, 64-65 


Programmable Option Select, 55 
CMOS RAM for, 527-530 
device ID for, 4, 153 
error handling of, 573 
hardware environment for, 571-572 
with Micro Channel, 33-34 
parallel port extended mode, 
39, 417 
port addresses for, 67, 69-70 
services for, 569-570 
Read POS Data from an Adapter, 
579-580 
Read Stored POS Data from 
CMOS RAM, 575-576 
Return Logical ID Parameters, 
574-575 
Write Dynamic POS Data from an 
Adapter, 581-582 
Write Stored POS Data from 
CMOS RAM, 577-578 


Programmed I/O for DMA controller, 
49, 547 
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P, cont’d 
Protected address mode, 31 
and CDA, 84 
environments for, building of, 13 
and math coprocessor, 32 
switching to, 478-480 
tables for, building of, 110-112 


Public data in Device Block, 89 
PUSH for control transfer, 17, 134 


R 


RAM extensions, 27, 160 
area for, 180 
header for, 169 
initialization of, 108, 178-179 
See also CMOS RAM; Memory 


Raw system scan codes, 280 


Read Block of Color Registers Video 
Service, 354-355 


Read Change Line Signal Status Disk- 
ette Service, 226-227 


Read CMOS RAM Service, 536-537 


Read DAC Color Register Video 
Service, 349-350 


Read Device Parameters functions, 4 

for CMOS RAM Service, 534 

for Direct Memory Access Service, 
555 

for Diskette Change Line signal, 
191 

for Diskette Service, 199-201 

for Fixed Disk Service, 242-244 

for Keyboard Security Service, 592 

for Parallel Port Service, 421-422 

for Pointing Device Service, 
500-502 

for Real Time Clock Service, 

— 449-451 

for Serial Communications Service, 
367-369 

for Video Service, 319-322 
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Read, Diskette Service, 208-210 
and Diskette Change Line signal, 
191 


Read, Error Log Service, 612-613 
Read, Fixed Disk Service, 249-250 


Read from I/O and Write to Memory, | 
DMA Service, 565-566 : 


Read Keyboard ID Bytes, Keyboard 
Service, 272-273 


Read Keyboard LED Status, Keyboard 
Service, 282-283 


Read Keyboard Scan Mode, nee 
Service, 289-291 


Read Media Parameters Digkeite 
Service, 221-222 


Read Palette Register Video Service, 
345-346 


Read Pointing Device Identification 
Code, 519-521 


Read POS Data from an Adapter, 
579-580 


Read standard function, 4 


Read Stored POS Data from CMOS 
RAM, 575-576 


- Read System Configuration, System 


Services, 473-474 


Read Time and Date, Real Time Clock 
Service, 465-466 


Read/write counters, PIT, 64-65 
Reading 
from CMOS RAM, 45 
of system control ports, 58 


Real address mode, 31 
and CDA, 84 
for initialization, 12, 95 
and math coprocessor, 32 
switching to, 475-477 
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Real time clock, 45-46, 524-525 
data for, 444-445 
device ID for, 4,153 
error handling for, 445 
hardware environment for, 443 
interrupt request for, 57 
return codes for, 619 
services for, 495-496 
Cancel Alarm Interrupt, 457 
Cancel Periodic Interrupt, 461 
Cancel Update-Ended Interrupt, 
464 
Default Interrupt Handler, 446 
Read Device Parameters, 
449-451 
Read Time and Date, 465-466 
Return Logical ID Parameters, 
447-448 
Set Alarm Interrupt, 454-456 
Set Device Parameters, 452 
Set Periodic Interrupt, 458-460 
Set Update—Ended Interrupt, 
462-463 
Write Time and Date, 466-467 


Receive Serial Communications 
Service, 389-398 


Recompute Checksum CMOS RAM 
Service, 540-541 


Redirection 
of cascade, interrupt request for, 
57 
of nonstaged functions, 184-185 
of staged functions, 186-188 


Reference diskette 
ADF files read by, 34, 55 
for passwords, 583-584 


Relative Block Addresses for fixed 
disk systems, 233 


REPLACE extension class, 163-164, 
174 


Request Blocks, 10, 94, 119-120, 
125, 128 


Index 


and ABIOSCommonEntry, 20, 152 

and control transfer, 18, 136 

and Default Interrupt Handlers, 
147-148 

and function requests, 132-133 

for hardware interrupt handling, 


142-145 
and initialization, 11, 15-16, 97, 
117, 132-133 


in Initialization Table, 101 

lifespan of, 15, 132 

parameters for, 121 

for Receive function, 390, 393-396 
return codes in, 24, 129, 140 
structure of, 122-124 

and time-out handlers, 149-150 
for Transmit function, 380, 382-386 
use of, 16 


Reserved data pointers, initialization 
of, 113 


Reserved fields in Request Blocks, 16 
Reset Diskette System function, 190 


Reset/Initialize functions, 4 

for Diskette Service, 190, 203-205 

for Fixed Disk Service, 244-248 

for Keyboard Service, 274-275 

for Parallel Port Service, 425 

for Pointing Device Service, 
503-504 

for Serial Communications Service, 
370-372 


Resolution 
and default fonts, 314 
for pointing devices, 514-515 
video, 309-310, 325 


Restore Video Environment, Video 
Service, 335-336 


Resume Stage after Interrupt return 
code, 25, 141, 618 


Resume Stage after Time Delay re- 
turn code, 25, 141, 150, 618 
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R, cont’d 


Retryable Device Error return code, 
25, 141 


Retryable Device Error With Time-—out 
return code, 25, 141 


Retryable diskette errors, 195 
Retryable errors, 25, 140-141, 238 
Retryable fixed disk errors, 238 


Retryable Time-out Error return code, 
25, 141 


Return Code Field Not Valid return 
code, 25, 141 


Return codes, 24-25, 129, 139-142, 
617 
action-required, 618 
for Default Interrupt Handler, 148 
for Diskette Service, 195 
for Fixed Disk Service, 238 
initialization of, 143 
for Keyboard Service, 268 
for Parallel Port Service, 418 
for Real Time Clock Service, 445 
for Request Blocks, 16, 123, 125 
for Serial Communications Service, 
363 | 

for System Timer Service, 437 
termination—indicating, 619-626 
for Video Service, 315 


Return Line Status, Serial Communi- 
cations Service, 409 


Return Logical ID Parameters func- 
tions, 4, 20, 152 

for CMOS RAM Service, 533-534 

and Default Interrupt Handlers, 147 

for Direct Memory Access Service, 
553 | 

for Diskette Service, 197-198 

for Error Log Service, 610-611 

for Fixed Disk Service, 240 

for Keyboard Security Service, 
590-591 

for Keyboard Service, 270 

for Nonmaskable Interrupt Service, 
488 | 
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for Parallel Port Service, 420-421 
for Pointing Device Service, 
499-500 
for POS Service, 574-575 
for Real Time Clock Service, 
447-448 
for Serial Communications Service, | 
365-366 ! 
for System Services, 471-472 | 
for System Timer Service, 439 | 
for Video Service, 317 


Return Modem Status Serial Commu- 
nications Service, 410-411 


Return Print Status Parallel Port 
Service, 432-433 


Return ROM Fonts Information Video 
Service, 331-332 


RGB data format, 356 
RLL fixed disk controller, 35 
Rogue interrupts, 144 


ROM 
ABIOS vs. CBIOS, 31 
fonts resident in, 313-314 


ROM extensions, 27, 160 
header for, 168 
initialization of, 176-177 
signature for, 168 


ROMCritSection and DOS compatibility 
box, 22-23, 154 


Rows, video, and fonts, 342 


S 


Sample rate for pointing devices, 
512-513 


Save Video Environment, Video 
Service, 333-334 


Scaling factor for pointing devices, 
516-517 
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S, cont’d 
Scan codes for Keyboard Service, 
263-267, 586-589 
reading of, 280-281 


Scratch register, serial port, 73, 79 


Secondary device ID in Initialization 
Table, 100-101 


Sector number and size in diskette 
formatting, 214, 223 


Sectors per track, fixed disk, 
236-237 


Security. See Keyboard, security 
services for 


Select Character Generator Block 
Video Service, 337-338 


Selector descriptors, 111 
Sequencer, video, 36, 307 


Serial buffer head pointer 
receive, 389 
transmit, 379, 382 
port address for, 75 


Serial buffer tail pointer 
receive, 389-390 
transmit, 379-380, 382 


Serial Port Service, support by, 115 


Serial ports 
addresses for, 40, 71-73, 77-79, 
361 
Device Block for, 367 
device ID for, 4, 153 
error handling for, 363 


hardware environment for, 361-363 


interrupt request for, 57 
and keyboard controller, 261 
return codes for, 620 
services for, 359-360 
Cancel, 407-408 
Default Interrupt Handler, 364 
Enable FIFO Control, 412-413 


Index 


Modem Status, 404-406 

Read Device Parameters, 
367-369 

Receive, 389-398 

Reset/Initialize Serial Port, 
370-372 

Return Line Status, 409 

Return Logical ID Parameters, 
365-366 

Return Modem Status, 410-411 

Set Baud Rate, 378 

Set Line Control, 375-377 

Set Modem Control, 374 

Transmit, 379-388 

Transmit and Receive, 399-403 


Serial Receive Buffer, 71, 77, 
389-391, 393-396 


Serial Receive Head Pointer, 
389-391, 393-396 


Serial Receive Tail Pointer, 389-391, 
393-396 


Serial-to-parallel conversions, 41, 
362 


Service codes for extensions, 26, 
159, 176 


Service-specific Entry Routines, 17 
for control transfer, 134-135 


Service-Specific Interrupt Routine, 
149 


Service-specific parameters, Request 
Block, 121, 123-124 | 


Service-Specific Unsuccessful Opera- 
tion return code, 25, 141 


Services, relationship of, to other 
structures, 14 


Set Alarm Interrupt Real Time Clock 
Service, 454-456 


Set Baud Rate Serial Communications 
Service, 378 
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S, cont’d 
Set Device Parameters function, 4 
for Diskette Service, 202-203 
for Parallel Port Service, 423-424 
for Real Time Clock Service, 452 


Set Keyboard LED Status service, 
284-285 


Set Keyboard Scan Mode Code, 
Keyboard Service, 292-295 


Set Line Control, Serial Communica- 
tions Service, 375-377 


Set Media Type for Format, Diskette 
Service, 223-225 


Set Modem Control, Serial Communi- 
cations Service, 374 


Set Periodic Interrupt, Real Time 
Clock Service, 458-460 


Set Resolution, Pointing Device 
Service, 514-515 


Set Sample Rate, Pointing Device 
Service, 512-513 


Set Scaling Factor, Pointing Device 
Service, 516-518 


Set state for Diskette Change Line 
signal, 191 


Set Typematic Rate and Delay, Key- 
board Service, 286-288 


Set Update-Ended Interrupt, Real 
Time Clock Service, 462-463 


Set Video Mode, Video Service, 
324-330 | 


sharing of hardware interrupts, 
144-145 


Shift key, 266-267, 587 
Shutdown, CMOS RAM, 525 
Signatures for extensions, 168 


single-staged functions, processing 
model of, 128 


Single-staged processing/single- 
tasking operating systems, 5-6 
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Single-tasking operating system, 31 
Slashes, 267, 588 | 
Speaker, enabling of, 483-484 
Speeds, microprocessor, 31 

ST506 fixed disk adapter, 35, 235 


Stacks and stack frame 
and ABlOSCall, 23, 155 
and ABIOSCommonEntry, 20, 152 
and extensions, 162 
loading of, 137 
pushing of pointers onto, 17, 134 
for System Parameter Table, 98 


Staged functions, redirection of, 
186-188 


Standard functions, 4 


Start Routines, 9, 131 
flags for, 143 
pointer for, 87-88, 98, 605 
and return codes, 24 
and staged function redirection, 186 


Status 
of function calls, 25-26 
modem, 404-406, 410 
of parallel ports, 39, 71, 74-75, 
417 
printer, 432-433 


Status registers 
diskette controller, 76 
DMA, 61, 68 
fixed disk adapter, 73 


Stop bits, serial support for, 40, 361 


Stored pointer method of frame 
loading, 137 


Structures. See Data structures 
Subaddress extension, POS, 70 
Successful return code, 25, 141 


Suspension of functions, 5, 22-23, 
154-155 
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S, cont’d 


Switch to Protected Mode, System 
services, 478-480 


switch to Real Mode System Serv- 
ices, 475-477 


Sys Req key, 267, 589 


System board ROMs, initialization of, 
108 


System board setup enable register, 
67 


System configuration, reading of, 
47-474 


System control port 
definitions for, 5-59 
port addresses or, 65-67 


System microprocessor, arbitration 
level for, 52 


System Parameters Table, building 
of, 13, 96, 98-99 


System scan codes, 280 
for Keyboard Security Service, 
586-589 
for Keyboard Service, 264-267 


system Services, 469 
device ID for, 4, 153 
error handling for, 470 
for Watchdog Timer, 44 
services for, 471-484 
Disable Address Line 20, 482 
Enable Address Line 20, 481 
Enable Speaker, 483-484 
Read System Configuration, 
473-474 
Return Logical ID Parameters, 
471-472 
Switch to Protected Mode, 
478-480 
Switch to Real Mode, 475-477 


System Timer Service and devices, 
42-46, 435 
Default Interrupt Handler, 438 
device ID for, 4, 153 


Index 


hardware environment for, 436-437 
Return Logical ID Parameters, 439 


T 


Termination, return codes indicating, 
619-626 


Text modes 
and character blocks, 314 
fonts for, 325, 339-344 
resolution of, 310, 325 
scan lines for, 327 


Time 
reading of, 465-466 
writing of, 466-467 
See also System Timer Service and 
devices 


Time—out errors, 140 
and keyboard, 268 
return code for, 25, 141 


Time-out parameter in Request Block 
structure table, 123 


Time-out routines, 8-9, 149-150, 162 
for function calling, 131 
pointer for, 87-88, 98 
and staged function redirection, 186 


Time-period handlers, 7-8, 130 
Time-related devices, 42 


Time to Wait Before Continuing Re- 
quest field, 421, 423 


Time to Wait for Printer Initialization 
field, 421, 423 


Timer channels, 43-44 


Timer services. See System Timer 
Service and devices 


Timer tick, interrupt request for, 57 
Touchpads, 495 


Track number in diskette formatting, 
214, 223 
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T, cont’d 
Track switching, diskette, 204 
Trackballs 495 


Transfer Control bytes field for DMA 
controller, 50, 547 


Transfer conventions, 17-18, 94 
ABIOS 136 
for function calling, 131, 134-136 
and initialization, 117 
operating system, 18, 137-138 
and Request Block, 125 
with time-out handlers, 149 


Transfer count registers, DMA, 61, 68 


Transfer Data Pointer Mode for CMOS 
RAM, 536, 538 


Transfer rates, diskette, 193 
Transfer status, DMA, 546, 560 


Transmit and Receive, Serial Commu- 
nications Service, 399-403 


Transmit Buffer, 379-382, 384-386, 
399 


Transmit Head Pointer, 379-382, 
384-386, 391, 399 


Transmit Holding Register, 71, 77, 
383, 385 


Transmit, Serial Communications 
Service, 379-388 


Transmit Tail Pointer, 379-382, 
384-386, 391, 399 


Turn Diskette Motor Off, Diskette 
Service, 228-229 


200 scan-line video, 310-311, 325 
Typematic rate and delay, 286-288 


U 


Unexpected Reset return code, 25, 
141, 618 
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Unit in Request Block structure table, 
122 


Unit-unique areas in Device Block, 92 


Update-ended interrupts, 441 
canceling of, 464 
setting of, 462-463 


V 


Nerify Diskette Data, Diskette Service, 


191 


Verify Diskette Sectors, Diskette 
Service, 218-220 


Verify Fixed Disk Data, Fixed Disk 
Service, 255-256 


VGA 
adapter for, 305 
chip for, 307-308 
and palette register, 312 
port addresses for, 74-76 
support for, 36 | 


Video 
device ID for, 4, 153 
error handling for, 315 
extension for, 184-185 
hardware for, 36-37 
hardware environment for, 307-308 
modes for, 309-313, 324-330 
monitor support for, 311-312 
ROM-resident fonts for, 313-314 
services for, 305-306 
Default Interrupt Handler, 316 
Enhanced Load Text Mode Font, 
342-344 
Load Text Mode Font, 339-341 
Read Block of Color Registers, 
354-355 
Read DAC Color Register, 
349-350 
Read Device Parameters, 
319-322 
Read Palette Register, 345-346 
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V, cont’d 

Restore Video Environment, 
335-336 

Return Logical ID Parameters, 317 

Return ROM Fonts Information, 
331-332 

Save Video Environment, 333-334 

Select Character Generator Block, 
337-338 

Set Video Mode, 324-330 

Write Block of DAC Color Regis- 
ters, 356-358 

Write DAC Color Register, 
351-353 

Write Palette Register, 347-348 


Video Mode field, 326 
Video subsystem register, VGA, 75 
Virtual DMA channels, 53, 551 


W 


WAIT signal, math coprocessor, 32 
Wait states, 5, 31 
Watchdog Timer, 44 


Work area in Request Block structure 
table, 124 


Write and Verify, Fixed Disk Service, 
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